Skip to main content
GET
/
api
/
public
/
identityChecks
/
my

List Identity Checks

Returns identity check requests for the authenticated customer. These are verification requests (e.g. ID upload, KYC) that the operator has configured as part of the onboarding or compliance process.

Authentication

Requires a valid customer bearer token.

Query Parameters

showPending
boolean
required
true — return only pending/incomplete checks. false — return all checks including completed ones.
_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation.

Response

Returns an IdentityChecksList object — a paginated list of identity check records.

Identity Check Fields

Identity

FieldTypeDescription
IdnumberUnique numeric identifier for the identity check

Core

FieldTypeDescription
NamestringCheck display name
DescriptionstringCheck description
NotesstringAdditional notes
VerificationTypestringType of verification (e.g. Identity, Address)
IdentityCheckProviderstringProvider used for the check
VerificationStatusstringCurrent status (Pending, Verified, etc.)
LastErrorstringLast error message (if any)

Contact

FieldTypeDescription
ContactIdnumberContact identifier
ContactFullNamestringContact full name
BusinessIdnumberLocation identifier
BusinessNamestringLocation display name

Documents

FieldTypeDescription
IdentityDocumentTypestringType of identity document
IdentityDocumentIssuedBystringIssuing authority
IdentityDocumentExpirationDatestring | nullDocument expiration date
AddressDocumentTypestringType of address document

Timestamps

FieldTypeDescription
CreatedOnUtcstringDate created (UTC)

Examples

Fetch pending checks

GET /api/public/identityChecks/my?showPending=true
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

const { resource: checks } = useTypedData(httpClient, endpoints.identity.list(true))