The VerificationReport object

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • client_reference_idnullable string

    A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.

  • createdtimestamp

    Time at which the object was created. Measured in seconds since the Unix epoch.

  • documentnullable object

    Result of the document check for this report.

  • emailnullable object

    Result of the email check for this report.

  • id_numbernullable object

    Result of the id number check for this report.

  • livemodeboolean

    If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

  • optionsnullable object

    Configuration options for this report.

  • phonenullable object

    Result of the phone check for this report.

  • selfienullable object

    Result of the selfie check for this report.

  • typeenum

    Type of report.

    Possible enum values
    document

    Perform a document check.

    id_number

    Perform an ID number check.

    verification_flow

    Configuration provided by verification flow

  • verification_flownullable string

    The configuration token of a verification flow from the dashboard.

  • verification_sessionnullable string

    ID of the VerificationSession that created this report.

The VerificationReport object
{
"object": "identity.verification_report",
"created": 1681337011,
"livemode": false,
"options": {
"document": {}
},
"type": "document",
"verification_session": "vs_NhaxYCqOE27AqaUTxbIZOnHw",
"document": {
"status": "verified",
"error": null,
"first_name": "Jenny",
"last_name": "Rosen",
"address": {
"line1": "1234 Main St.",
"city": "San Francisco",
"state": "CA",
"zip": "94111",
"country": "US"
},
"type": "driving_license",
"files": [
],
"expiration_date": {
"month": 12,
"day": 1,
"year": 2025
},
"issued_date": {
"month": 12,
"day": 1,
"year": 2020
},
"issuing_country": "US"
}
}

Retrieve a VerificationReport

GET /v1/identity/verification_reports/:id

Retrieves an existing VerificationReport

Parameters

No parameters.

Returns

Returns a VerificationReport object

curl https://api.stripe.com/v1/identity/verification_reports/{{VERIFICATION_REPORT_ID}} \
-u "sk_test_Hrs6SAopgFPF0bZXSN3f6ELNsk_test_Hrs6SAopgFPF0bZXSN3f6ELN:"
Response
{
"object": "identity.verification_report",
"created": 1681337011,
"livemode": false,
"options": {
"document": {}
},
"type": "document",
"verification_session": "vs_NhaxYCqOE27AqaUTxbIZOnHw",
"document": {
"status": "verified",
"error": null,
"first_name": "Jenny",
"last_name": "Rosen",
"address": {
"line1": "1234 Main St.",
"city": "San Francisco",
"state": "CA",
"zip": "94111",
"country": "US"
},
"type": "driving_license",
"files": [
],
"expiration_date": {
"month": 12,
"day": 1,
"year": 2025
},
"issued_date": {
"month": 12,
"day": 1,
"year": 2020
},
"issuing_country": "US"
}
}

List VerificationReports

GET /v1/identity/verification_reports

List all verification reports.

Parameters

  • client_reference_idstring

    A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.

  • createdobject

    Only return VerificationReports that were created during the given date interval.

  • typeenum

    Only return VerificationReports of this type

    Possible enum values
    document

    Perform a document check.

    id_number

    Perform an ID number check.

  • verification_sessionstring

    Only return VerificationReports created by this VerificationSession ID. It is allowed to provide a VerificationIntent ID.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

List of VerificationInent objects that match the provided filter criteria.

curl -G https://api.stripe.com/v1/identity/verification_reports \
-u "sk_test_Hrs6SAopgFPF0bZXSN3f6ELNsk_test_Hrs6SAopgFPF0bZXSN3f6ELN:" \
-d limit=3
Response
{
"object": "list",
"url": "/v1/identity/verification_reports",
"has_more": false,
"data": [
{
"object": "identity.verification_report",
"created": 1681337011,
"livemode": false,
"options": {
"document": {}
},
"type": "document",
"verification_session": "vs_NhaxYCqOE27AqaUTxbIZOnHw",
"document": {
"status": "verified",
"error": null,
"first_name": "Jenny",
"last_name": "Rosen",
"address": {
"line1": "1234 Main St.",
"city": "San Francisco",
"state": "CA",
"zip": "94111",
"country": "US"
},
"type": "driving_license",
"files": [
],
"expiration_date": {
"month": 12,
"day": 1,
"year": 2025
},
"issued_date": {
"month": 12,
"day": 1,
"year": 2020
},
"issuing_country": "US"
}
}
]
}
Morty Proxy This is a proxified and sanitized view of the page, visit original site.