GET//
Use this endpoint to retrieve a specific KYC result.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the KYC verification for which you want to retrieve the result. Allowable Values: Existing identity check token |
Response body
| Fields | Description |
|---|---|
| business_token string Conditionally returned | The business account holder on which the identity check was performed. Allowable Values: Existing business token |
| created_time datetime Returned | Time when the KYC verification was performed. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| last_modified_time datetime Returned | Time when the KYC verification was last updated. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| manual_override boolean Conditionally returned | If true, the user account holder is designated as having passed a verification check without Marqeta performing the check.This override is used when verification is performed through another mechanism, such as an alternative KYC provider or directly with the account holder. Allowable Values: true, false |
| notes string Conditionally returned | Notes pertaining to a manual override. This field is included in the response only when the manual_override field is set to true.Allowable Values: 255 char max |
| reference_id string Conditionally returned | If you verified the account holder’s identity by performing a KYC verification outside of the Marqeta platform, you can use the reference_id field to store the reference number returned by that KYC provider. This field is included in the response only when the manual_override field is set to true.NOTE: When you submit a KYC verification request with manual_override=false, the Marqeta platform performs the verification through one of its KYC providers. If the KYC provider responds with a reference identifier, that identifier is passed to you by way of this field in the response.Allowable Values: 32 char max |
| result object Conditionally returned | Contains information about the KYC verification result. Allowable Values: Existing KYC verification object |
| result.codes array of objects Conditionally returned | An array of KYC verification result code objects. Allowable Values: One or more KYC verification result code objects |
| result.codes[].code string Conditionally returned | For any pending or failure outcome, see the User KYC failure codes table, the Outcome reasons for the business table, or the Outcome reasons for individuals associated with a business table.Allowable Values: AddressIssue, DateofBirthIssue, Denied KYC, NameIssue, NoRecordFound, OFACFailure, RiskIssue, SSNIssue, warm address alert, Watchlist |
| result.codes[].message string Conditionally returned | Result code description. Allowable Values: 255 char max |
| result.status string Conditionally returned | KYC verification status. Allowable Values: success, failure, pending |
| token string Conditionally returned | The unique identifier of the identity check. Allowable Values: Existing identity check token |
| user_token string Conditionally returned | The user account holder on which the identity check was performed. Allowable Values: Existing user token |
Sample response body
JSON
{
"created_time": "2025-03-07T22:52:39Z",
"last_modified_time": "2025-03-07T22:52:39Z",
"token": "my_user_01_kyc_01",
"user_token": "my_user_01",
"result": {
"status": "success"
},
"manual_override": false
}