Submit agent customer for verification

Submit the authenticated agent’s individual customer for KYC verification. The response reports the current status and any identity fields that still need to be supplied. Requires the MANAGE_IDENTITY permission in the agent’s policy.

POST /agents/me/verifications

Submit agent customer for verification

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/agents/me/verifications \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "Verification:019542f5-b3e7-1d02-0000-000000000001",
  "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
  "verificationStatus": "RESOLVE_ERRORS",
  "errors": [
    {
      "resourceId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "type": "MISSING_FIELD",
      "reason": "Business address line 1 is required",
      "field": "customer.address.line1",
      "acceptedDocumentTypes": [
        "PASSPORT"
      ]
    }
  ],
  "createdAt": "2025-10-03T12:00:00Z",
  "updatedAt": "2025-10-03T12:00:00Z"
}

Authorizations

Authorization · string · header · required

Bearer token authentication for agent-scoped endpoints. The token is the accessToken returned when redeeming a device code via POST /agents/device-codes/redeem. Agent credentials are user-scoped: all requests are automatically bound to the agent's associated customer and subject to the agent's policy.

Response

200

application/json

Verification status returned

id · string · required

Unique identifier for this verification

Example:

"Verification:019542f5-b3e7-1d02-0000-000000000001"

customerId · string · required

The ID of the customer being verified

Example:

"Customer:019542f5-b3e7-1d02-0000-000000000001"

verificationStatus · enum<string> · required

Current status of the KYC/KYB verification

Available options: RESOLVE_ERRORS, PENDING_MANUAL_REVIEW, IN_PROGRESS, APPROVED, REJECTED, READY_FOR_VERIFICATION

Example:

"RESOLVE_ERRORS"

errors · object[] · required

List of issues preventing verification from proceeding. Empty when verificationStatus is APPROVED or IN_PROGRESS.

Show child attributes

createdAt · string<date-time> · required

When this verification was created

Example:

"2025-10-03T12:00:00Z"

updatedAt · string<date-time>

When this verification was last updated

Example:

"2025-10-03T12:00:00Z"