Get a verification

Retrieve details of a specific verification by ID.

GET /verifications/{verificationId}

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/verifications/{verificationId} \
  --header 'Authorization: Basic <encoded-value>'

import LightsparkGrid from '@lightsparkdev/grid';

const client = new LightsparkGrid({
  username: process.env['GRID_CLIENT_ID'], // This is the default and can be omitted
  password: process.env['GRID_CLIENT_SECRET'], // This is the default and can be omitted
});

const verification = await client.verifications.retrieve('verificationId');

console.log(verification.id);

package com.lightspark.grid.example

import com.lightspark.grid.client.LightsparkGridClient
import com.lightspark.grid.client.okhttp.LightsparkGridOkHttpClient
import com.lightspark.grid.models.verifications.Verification
import com.lightspark.grid.models.verifications.VerificationRetrieveParams

fun main() {
    val client: LightsparkGridClient = LightsparkGridOkHttpClient.fromEnv()

    val verification: Verification = client.verifications().retrieve("verificationId")
}

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"
}

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

{
  "status": 404,
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

verificationId · string · required

Verification ID

Response

200

application/json

Successful operation

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"