> This page is for version v1 (default).
> For other versions, use one of these documentation indexes:
> - v1 (default): https://developers.truemed.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.truemed.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.truemed.com/_mcp/server.

# Retrieve Provision Token Request

GET https://dev-api.truemed.com/api/v1/payment_tokens/provision_request/{provision_token_request_id}

Check the status of a [`create_payment_token`](/api-reference/payment-tokens/create-payment-token)
or [`update_payment_token`](/api-reference/payment-tokens/update-payment-token) API calls.

The `retrieve_provision_token_request` endpoint returns details about the request to
create or update a `payment_token`. This endpoint is only provided as a fall back to
the [`payment_token_updated`](/api-reference/payment-tokens/payment-token-updated-webhook) webhook and is only necessary
for as fallback for the [`payment_token_updated`](/api-reference/payment-tokens/payment-token-updated-webhook) webhook.

## Request Notes

**Path Params:**
- **provision_token_request_id** (Required): The `provision_token_request_id` string
  returned by Truemed to the partner either:
  - in response to a [`create_payment_token`](/api-reference/payment-tokens/create-payment-token) request
  - in a response to a [`update_payment_token`](/api-reference/payment-tokens/update-payment-token) request

## Response Notes

### Success Case

**HTTP Status: 200**

- **payment_token** (Optional): string - the `payment_token` created as part of the
  `provision_request`, if one exists. Null otherwise.
  - Use the [`retrieve_payment_token`](/api-reference/payment-tokens/retrieve-payment-token) endpoint to get
    more information on the token.
- **metadata**: (Optional) - returned if supplied in the call to
  [`create_payment_token`](/api-reference/payment-tokens/create-payment-token).

Reference: https://developers.truemed.com/api-reference/payment-tokens/retrieve-payment-token-provision-request

## Authentication

- `x-truemed-api-key` header (required) — Sales channel API key for merchant server-to-server authentication

## Servers

- `https://dev-api.truemed.com` (Development server, default)
- `https://api.truemed.com` (Production server)

## Request

### Path parameters

- `provision_token_request_id` (string, required) — The ID of a ProvisionTokenRequest returned via create_payment_token

## Response

### 200

Successful response

- `metadata` (string, required, nullable) — The metadata string you provided as part of the create_payment_token request for the ProvisionTokenRequest. Will be null if no metadata was provided
- `payment_token` (string, required, nullable) — The PaymentToken created as part of create_payment_token for the ProvisionTokenRequest. Will be null if the PaymentToken has not been provisioned yet

## Errors

### 400 Bad Request Error

Bad Request

- `error` (enum, required)
  - Allowed values: `FeatureNotEnabled`, `TotalAmountInvalid`, `ValidationError`
- `message` (string, required)

### 404 Not Found Error

Not Found

- `error` (enum, required)
  - Allowed values: `NotFound`
- `message` (string, required)

### 405 Method Not Allowed Error

Method Not Allowed

- `error` (enum, required)
  - Allowed values: `MethodNotAllowed`
- `message` (string, required)

### 500 Internal Server Error

Internal Server Error

- `error` (enum, required)
  - Allowed values: `ServerError`
- `message` (string, required)

### 501 Not Implemented Error

Not Implemented

- `error` (enum, required)
  - Allowed values: `NotImplemented`
- `message` (string, required)

## Examples

**Response**

```json
{
  "metadata": "string",
  "payment_token": "string"
}
```

**SDK Code**

```python
import requests

url = "https://dev-api.truemed.com/api/v1/payment_tokens/provision_request/provision_token_request_id"

headers = {"x-truemed-api-key": "<apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://dev-api.truemed.com/api/v1/payment_tokens/provision_request/provision_token_request_id';
const options = {method: 'GET', headers: {'x-truemed-api-key': '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```