---
title: "Get allocation"
url: https://docs.truemarkets.co/api/gateway/get-allocation
description: "Returns the current state of an allocation."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get allocation

```
GET https://api.truemarkets.co/v1/gateway/cefi/allocations/{id}
```

Returns the current state of an allocation.

## Authentication

Bearer token in `Authorization`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `TM-On-Behalf-Of` | header | string (uuid) | no | Act as one of your organization's users. The value is the `user_id` returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: `400` for a personal token, a repeated header or a non-UUID, `403` for a user outside your organization. Not accepted on organization-scoped routes. |
| `id` | path | string (uuid) | yes | Allocation ID (UUID) |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Allocation retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | Allocation identifier |
| `status` | string, one of `allocating`, `crediting`, `releasing`, `completed`, `rejected`, `stranded` | yes | Where the allocation stands. * **allocating** — The amount is being allocated in the wallet. * **crediting** — The amount is allocated and is being credited to CeFi. * **releasing** — The allocation was refused and the amount is being freed in the wallet. * **completed** — The amount is available to trade on CeFi. * **rejected** — The allocation was refused and the amount is free in the wallet again. * **stranded** — The outcome is unknown and support has to resolve it. |
| `asset_id` | string (uuid) | yes | DeFi listing identifier (UUID) |
| `asset_symbol` | string | yes | Symbol of the listing |
| `amount` | string | yes | Amount this allocation sets aside, as a decimal string |
| `allocated_total` | string | no | Everything the caller has allocated of the listing after this allocation, as a decimal string |
| `transfer` | object | no | The CeFi transfer an allocation or release started, under the exchange's id |
| `transfer.id` | string | yes | Exchange transfer identifier |
| `transfer.status` | string, one of `INITIALIZED`, `PENDING`, `PROCESSING`, `COMPLETED`, `REJECTED`, `FAILED` | yes | Status as last seen from the exchange |
| `failure_reason` | string | no | Why the allocation was refused or stranded |
| `created_at` | string (date-time) | yes |  |
| `updated_at` | string (date-time) | yes |  |

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 404

Not found

### 500

Internal server error