---
title: "Get all fullcover orders for an account."
method: GET
path: "/v3/orders/fullcover/"
tags: ["orders"]
---

# Get all fullcover orders for an account.

`GET /v3/orders/fullcover/`

## Query parameters

- `states` string[] — Order states to filter by. By default all order states are returned
- `limit` integer — Maximum number of orders to be retrieved in one API call
- `pagination_last_id` string — Epoch timestamp of the last order from the previous page, so we can fetch the subsequent orders.<br> Pages are sorted by the bet created time descending.
- `include_promotion_data` boolean — Whether to enrich the response with bet token and promotion data.<br> Set to false to skip the promotion lookup when those fields are not needed, in which case they are returned empty

## Response `200`

Orders success response

- object — Orders success response
  - `orders` object[], required
    - `buy_reference_id` string — To handle retries over flaky network. Same value sent twice will result in `DUPLICATE_TRADE` error instead of 2 duplicate bets
    - `cashed_out_amount` number, required
    - `cashed_out_quantity` integer, required
    - `created_datetime` string, date-time, required — When was the order created
    - `fullcover_type` string, required
    - `last_modified_datetime` string, date-time, required — When was the order last modified, usually by the exchange matching it
    - `number_of_bets` integer, required
    - `original_bets` object[]
      - `contract_id` string, required — This ID uniquely identifies the contract
      - `market_id` string, required — This ID uniquely identifies the market
      - `price` integer, required — This price is in percentage basis points.<br> Example: 5000 = 50% <br> To convert it to decimal odds, just divide 10000 by it<br> Example: 10000 / 5000 = 2.0 (decimal odds).<br> This price has to conform to a valid tick on the exchange; an invalid price error will be returned if it does not.
      - `quantity` integer, required — Quantity is the sum of the total pot (back+lay) in case the order is matched<br> The units are 1/10000 * one unit of the user's currency.<br> Example: Quantity 500 = 0.05 GBP<br> To convert it to back stake, just multiply by the price and divide by 100000000<br> Example: 100000 (quantity) * 5000 (price) / 100000000 = 5 GBP back stake<br> The minimum stake is £0.05 or currency equivalent
      - `token_used` object, required
        - `bet_token_type` 'free_bet' | 'boost_bet', nullable, required
        - `boost_percent` number, nullable, required
        - `original_price` integer, nullable — This price is in percentage basis points.<br> Example: 5000 = 50% <br> To convert it to decimal odds, just divide 10000 by it<br> Example: 10000 / 5000 = 2.0 (decimal odds).<br> This price has to conform to a valid tick on the exchange; an invalid price error will be returned if it does not.
    - `original_contracts` object[], required
      - `contract_id` string, required — This ID uniquely identifies the contract
    - `potential_returns` number, required
    - `reference_id` string, required — To handle retries over flaky network. Same value sent twice will result in `DUPLICATE_TRADE` error instead of 2 duplicate bets
    - `returned_amount` number, required
    - `side` 'buy' | 'sell', required — side can either be:<ul> <li>buy: backing a contract <li>sell: laying a contract </ul>
    - `stake` number, required — Stake of an order
    - `state` 'created' | 'partial' | 'filled' | 'settled', required — Order state can be one of four values: <ul> <li>created: The first state of the order after creation, this order is unmatched <li>partial: The order is partially matched <li>filled: The order is fully matched <li>settled: The order has settled, the final state of orders.
  - `pagination` object, required
    - `next_page` string, nullable, required — The url query string for clients to fetch the next page of orders

## Other responses

- `400` — REQUEST_VALIDATION_ERROR
- `401` — AUTH_REQUIRED
- `403` — FORBIDDEN
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — ZEUS_UNAVAILABLE, ZEUS_CONNECTION_ERROR
- `504` — ZEUS_TIMEOUT

---

[API](https://skmtc.dev/smarkets/apis/smarkets-http-api.md) · [All operations](https://skmtc.dev/smarkets/apis/smarkets-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smarkets/smarkets-http-api/revisions/75f7e3050340/schema)
