LIlightsparkdev
KYC/KYB Verifications

List verifications

Changed on

Retrieve a list of verifications with optional filtering by customer ID and status.

get/verifications

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/verifications
  • Auth
    HTTP basic

Query parameters

customerIdstring

Filter by customer ID

verificationStatus'RESOLVE_ERRORS' | 'PENDING_MANUAL_REVIEW' | 'IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'READY_FOR_VERIFICATION'

Current status of the KYC/KYB verification

Example:RESOLVE_ERRORS

Filter by verification status

limitinteger

Maximum number of results to return (default 20, max 100)

cursorstring

Cursor for pagination (returned from previous request)

Response

Successful operation

hasMoreboolean required

Indicates if more results are available beyond this page

nextCursorstring

Cursor to retrieve the next page of results (only present if hasMore is true)

totalCountinteger

Total number of results matching the criteria

Example response

{
  "data": [
    {
      "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",
          "field": "customer.address.line1",
          "acceptedDocumentTypes": [
            "PASSPORT"
          ],
          "reason": "Business address line 1 is required"
        }
      ],
      "createdAt": "2025-10-03T12:00:00Z",
      "updatedAt": "2025-10-03T12:00:00Z"
    }
  ]
}

Changes

  • 9e646a130ea0Revision changes
    • warning

      added the new RESIDENCE_PERMIT enum value to the ///// response property for the response status

  • d996ddfb9d2bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status