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

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

​
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

​
type
string
required
Verification type: individual or business
​
sessionId
string
required
The session ID from the registration response (UUID format)

​
Response Fields

​
sessionId
string
required
The session ID
​
status
string
required
Current status: pending, submitted, completed, rejected, or retry
​
userId
string
User ID (present when session has an identity)
​
completedAt
string
ISO 8601 timestamp (only present when completed)
​
verifiedWallets
array
Wallets connected to this session. Populated when completed.
​
unverifiedWallets
array
Wallets connected to this session. Populated when not completed.

​
Status Values

StatusDescription
pendingSession created, user in verification process
submittedDocuments submitted, awaiting manual operator review
completedVerification successful, user is verified
rejectedVerification permanently failed (fraud, sanctions)
retryFixable 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