---
api: 'Revolut X Crypto Exchange REST API'
---

# Get fills of order by ID

Retrieves the fills (trades) associated with a specific order belonging to the client.
The user context is resolved based on the provided API key.

## Endpoint

GET `/orders/fills/{venue_order_id}`

## Parameters

### header parameters

- `X-Revx-Timestamp` (integer, required)
  Current timestamp in Unix epoch milliseconds. 
  Used to prevent replay attacks and construct the signature.
  Provided with other authentication headers.

- `X-Revx-Signature` (string, required)
  The Ed25519 signature of the request. 
  Provided with other authentication headers.
  
  :::tip
  See **Authentication headers: Signing a request** for details on how to generate this.
  :::

### path parameters

- `venue_order_id` (string, required)
  Unique identifier (UUID) of the venue order

## Returns

### 200

OK - Order fills retrieved successfully

#### Response attributes

- `data` (array of object)
  - `data[].tdt` (integer)
      Trade date and time, expressed in Unix epoch milliseconds.
  - `data[].aid` (string)
      Crypto-asset ID code.
  - `data[].anm` (string)
      Crypto-asset full name.
  - `data[].p` (string)
      Price in major currency units. For example, for USD, `116243.32` represents 116243.32 dollars.
  - `data[].pc` (string)
      Price currency.
  - `data[].pn` (string)
      Price notation.
  - `data[].q` (string)
      Quantity.
  - `data[].qc` (string)
      Quantity currency.
  - `data[].qn` (string)
      Quantity notation.
  - `data[].ve` (string)
      Venue of execution. Always equals `REVX`.
  - `data[].pdt` (integer)
      Publication date and time, expressed in Unix epoch milliseconds.
  - `data[].vp` (string)
      Venue of publication. Always equals `REVX`.
  - `data[].tid` (string)
      Transaction identification code.
  - `data[].oid` (string)
      Unique identifier for the order associated with the trade.
  - `data[].s` (enum, optional)
      Indicates the trade direction of the order.
      Possible enum values:

      - `buy`
      - `sell`
  - `data[].im` (boolean)
      Indicates whether the trade was a maker (true) or taker (false).

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 409 | Conflict |
| 429 | Rate Limit Exceeded |
| 5XX | Server Error |