Skip to main content
GET
Search CoworkerIdentityChecks
Customer ID checks verify a customer’s identity or address for a location through operator-reviewed documents or Stripe Identity, and track progress from pending through completion.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerIdentityCheck-List role.

Enums

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the location that owns this identity check..
string
Filter by display value for Business.Name..
integer
Filter by iD of the customer whose identity or address is being verified..
string
Filter by display value for Coworker.FullName..
string
Filter by display value for Coworker.CoworkerType..
string
Filter by display value for Coworker.CompanyName..
string
Filter by display value for Coworker.BillingName..
string
Filter by required operator-facing label for this verification check..
integer
Filter by how the check is performed: Manual for operator-reviewed documents, or StripeIdentity for a Stripe Identity session..
integer
Filter by identity document type when VerificationType is IdDocument: Passport, DriversLicense, IdCard, UniformedServiceId, CertificateOfNaturalization, AccessCard, MatriculaConsular, ResidentCard, UniversityId, NEXUSCard, or Other..
string
Filter by optional number or identifier printed on the identity document..
string
Filter by optional authority or organization that issued the identity document..
string
Filter by optional expiration date recorded on the identity document..
integer
Filter by address document type when VerificationType is Address: Passport, DriversLicense, IdCard, LeaseRentalAgreement, InsurancePolicy, Mortgage, VehicleRegistrationCard, VoterCard, or Other..
integer
Filter by purpose of the check: IdDocument for identity verification or Address for address verification..
string
Filter by optional free-text notes describing this verification check..
integer
Filter by read-only verification lifecycle status: Pending, Submitted, Successful, Failed, or Cancelled; manual checks derive it from their document records..
string
Filter by read-only most recent error message reported when the verification fails..
boolean
Filter by internal billing-processing flag managed by the platform; do not inspect or set it..
string
Filter by internal GUID linking this check to the proposal that created it; managed by proposal automation..
string
Filter by internal GUID linking this check to the contract that created it; managed by contract workflows..
string
Filter by internal GUID identifying the contract contact being verified; managed by contract workflows..
string
Filter by internal Stripe Identity session identifier managed by the Stripe verification integration..
string
Filter by internal GUID that groups checks generated from one multi-check creation request..
integer
Filter by optional provider for a second check created with this request: Manual or StripeIdentity; requires VerificationType1..
integer
Filter by optional purpose for a second check created with this request: IdDocument or Address; requires IdentityCheckProvider1..
string
Filter by optional notes for the second check created with this request; used only with VerificationType1..
integer
Filter by optional provider for a third check created with this request: Manual or StripeIdentity; requires VerificationType2..
integer
Filter by optional purpose for a third check created with this request: IdDocument or Address; requires IdentityCheckProvider2..
string
Filter by optional notes for the third check created with this request; used only with VerificationType2..

Range Filters

string
Filter by optional expiration date recorded on the identity document. greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by optional expiration date recorded on the identity document. less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

CoworkerIdentityCheck[]
The list of CoworkerIdentityCheck records matching the query. See the Get one CoworkerIdentityCheck endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each CoworkerIdentityCheck. The following fields are not populated in the Records[] response: Description, IdentityCheckProvider1, VerificationType1, Description1, IdentityCheckProvider2, VerificationType2, Description2.To get all fields, fetch the full record using the Get one CoworkerIdentityCheck endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response