> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve KYC result

> Use this endpoint to retrieve a specific KYC result.

GET/kyc/\{token}

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](https://www.marqeta.com/docs/core-api/kyc-verification/list-results-user.md#_user_kyc_failure_codes) table, the [Outcome reasons for the business](https://www.marqeta.com/docs/core-api/kyc-verification/list-results-business.md#_outcome_reasons_for_the_business) table, or the [Outcome reasons for individuals associated with a business](https://www.marqeta.com/docs/core-api/kyc-verification/list-results-business.md#_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 JSON lines wrap theme={null}
{
  "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
}
```


## Related topics

- [KYC Verification Overview](https://www.marqeta.com/docs/core-api/kyc-verification.md)
- [About KYC Verification](https://www.marqeta.com/docs/developer-guides/about-kyc.md)
- [List KYC results for a user](https://www.marqeta.com/docs/core-api/kyc-verification/list-results-user.md)
- [List KYC results for a business](https://www.marqeta.com/docs/core-api/kyc-verification/list-results-business.md)
- [Perform KYC verification](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md)