> ## 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 user transition

> Retrieve a user transition.

GET/usertransitions/\{token}

Retrieve a user transition.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the user transition you want to retrieve. **Allowable Values:**  Existing user transition token |

## URL query parameters

| Fields | Description |
| - | - |
| fields string  Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields. **Allowable Values:**  Comma-delimited list of fields, or blank |

## Response body

| Fields | Description |
| - | - |
| channel string  Returned | Mechanism by which the transaction was initiated. **Allowable Values:**  `API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM` |
| created\_time datetime  Conditionally returned | Date and time when the resource was created, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| created\_timestamp datetime  Conditionally returned | Date and time when the resource was created. Expressed in UTC, with millisecond precision. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ss:SSSZ |
| last\_modified\_time datetime  Conditionally returned | Date and time when the resource was last modified, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| reason string  Conditionally returned | Additional information about the status change. **Allowable Values:**  255 char max |
| reason\_code string  Returned | Identifies the standardized reason for the transition: **00:** Object activated for the first time. **01:** Requested by you. **02:** Inactivity over time. **03:** This address cannot accept mail or the addressee is unknown. **04:** Negative account balance. **05:** Account under review. **06:** Suspicious activity was identified. **07:** Activity outside the program parameters was identified. **08:** Confirmed fraud was identified. **09:** Matched with an Office of Foreign Assets Control list. **10:** Card was reported lost. **11:** Card information was cloned. **12:** Account or card information was compromised. **13:** Temporary status change while on hold/leave. **14:** Initiated by Marqeta. **15:** Initiated by issuer. **16:** Card expired. **17:** Failed KYC. **18:** Changed to `ACTIVE` because information was properly validated. **19:** Changed to `ACTIVE` because account activity was properly validated. **20:** Change occurred prior to the normalization of reason codes. **21:** Initiated by a third party, often a digital wallet provider. **22:** PIN retry limit reached. **23:** Card was reported stolen. **24:** Address issue. **25:** Name issue. **26:** SSN issue. **27:** DOB issue. **28:** Email issue. **29:** Phone issue. **30:** Account/fulfillment mismatch. **31:** Other reason. **86:** Notification of death. **Allowable Values:**  `00`, `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`, `31`, `86` |
| status string  Returned | Specifies the new status of the user. **Allowable Values:**  `UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED` |
| token string  Returned | Unique identifier of the user transition. **Allowable Values:**  Existing user transition token |
| user\_token string  Conditionally returned | Unique identifier of the user whose status was transitioned. **Allowable Values:**  Existing user token |
| metadata object  Conditionally returned | Associates customer-injected metadata with the user. Returned if part of the call to `POST /users`. **Allowable Values:**  The names and values of up to 20 fields |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "activate_05",
  "user_token": "my_user_01",
  "status": "ACTIVE",
  "reason_code": "00",
  "reason": "Activating user",
  "channel": "API",
  "created_time": "2025-03-15T00:00:00Z",
  "metadata": {
    "my_name_1": "my_value_1",
    "my_name_2": "my_value_2"
  }
}
```


## Related topics

- [User Transitions Overview](https://www.marqeta.com/docs/core-api/user-transitions.md)
- [List transitions for user](https://www.marqeta.com/docs/core-api/user-transitions/list-transitions-for-user.md)
- [Retrieve all deposit account transitions](https://www.marqeta.com/docs/core-api/deposit-accounts-v3/account-transitions-v3/retrieve-all-transitions.md)
- [Retrieve deposit account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v3/account-transitions-v3/retrieve-deposit-account-transition.md)
- [Retrieve card transition](https://www.marqeta.com/docs/core-api/card-transitions/retrieve-card-transition.md)