Get Session Status

Retrieve the current status of a verification session. Use this for polling-based status checks.

Individual (KYC)
Business (KYB)

Request

cURL

curl -X GET "https://api.identity.predicate.io/api/v1/status/individual/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $PREDICATE_KYC_API_KEY"

Request

cURL

curl -X GET "https://api.identity.predicate.io/api/v1/status/business/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $PREDICATE_KYC_API_KEY"

Response (Completed)

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "userId": "user-uuid-here",
  "completedAt": "2025-01-21T10:30:00Z",
  "verifiedWallets": [
    { "id": "wallet-uuid-1", "address": "0x1234...", "chain": "ethereum" },
    { "id": "wallet-uuid-2", "address": "0x5678...", "chain": "polygon" }
  ],
  "unverifiedWallets": []
}

Response (Pending)

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "verifiedWallets": [],
  "unverifiedWallets": [
    { "id": "wallet-uuid", "address": "0x1234...", "chain": "ethereum" }
  ]
}

Endpoint

GET https://api.identity.predicate.io/api/v1/status/{type}/{sessionId}

Path Parameters

string

required

Verification type: individual or business

string

required

The session ID from the registration response (UUID format)

Response Fields

string

required

The session ID

string

required

Current status: pending, submitted, completed, rejected, or retry

string

User ID (present when session has an identity)

string

ISO 8601 timestamp (only present when completed)

array

Wallets connected to this session. Populated when completed.

array

Wallets connected to this session. Populated when not completed.

Status Values

Status	Description
`pending`	Session created, user in verification process
`submitted`	Documents submitted, awaiting manual operator review
`completed`	Verification successful, user is verified
`rejected`	Verification permanently failed (fraud, sanctions)
`retry`	Fixable issue (e.g., blurry document), user can retry

Important: A submitted status means documents are under manual review. The wallet is not verified until status becomes completed.

Authentication

Authorization: Bearer YOUR_API_KEY

Essentials

Compliance For

Identity Solution

Get Session Status

Request

Request

Response (Completed)

Response (Pending)

Endpoint

Path Parameters

Response Fields

Status Values

Authentication

​Request

​Request

​Response (Completed)

​Response (Pending)

​Endpoint

​Path Parameters

​Response Fields

​Status Values

​Authentication

Request

Request

Response (Completed)

Response (Pending)

Endpoint

Path Parameters

Response Fields

Status Values

Authentication