CoworkerIdentityChecks
Search CoworkerIdentityChecks
Search and list CoworkerIdentityCheck records with filtering, sorting, and pagination.
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
eIdentityCheckProvider — IdentityCheckProvider values
eIdentityCheckProvider — IdentityCheckProvider values
eIdentityCheckDocumentType — IdentityDocumentType values
eIdentityCheckDocumentType — IdentityDocumentType values
eAddressCheckDocumentType — AddressDocumentType values
eAddressCheckDocumentType — AddressDocumentType values
eIdVerificationType — VerificationType values
eIdVerificationType — VerificationType values
eIdVerificationStatus — VerificationStatus values
eIdVerificationStatus — VerificationStatus values
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.
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