Get orders history

Returns orders history. Each order row includes a currency field: amounts on that row (discount, totalPrice, and line price / totalPrice) use that order currency, which may be any ISO 4217 code the platform stored for the purchase (for example EUR, USD, or PLN). Placing a new order via Create order still requires currency: EUR on the request.

Endpoint: GET /export/v1/orders

Headers

Header	Required	Description
`Authorization`	Yes	Bearer token obtained from the OAuth2 token endpoint. Format: `Bearer <access_token>`. See Authentication.

Query parameters

Date range filters on this endpoint accept RFC 3339 datetime format (dateFrom / dateTo): use YYYY-MM-DDTHH:MM:SSZ with time and time zone.

Parameter	Type	Required	Description
`page`	string	No	Pagination page (e.g. 2 of 10 pages). Min. 1, Max. 100000. Example: `2`
`itemsPerPage`	string	No	Items displayed per page. Possible values: `10`, `20`, `50` and `100`. Example: `100`
`status`	string	No	Filter orders by status (pending, processing, complete, canceled, closed, held). Example: `complete`
`orderId`	string	No	Filter by specified order identifier (e.g. from create order response). Example: `92000000289147`
`dateFrom`	string (datetime)	No	Inclusive lower bound on order creation datetime. Format: `YYYY-MM-DDTHH:MM:SSZ` (RFC 3339). Example: `2026-01-01T00:00:00Z`
`dateTo`	string (datetime)	No	Inclusive upper bound on order creation datetime. Format: `YYYY-MM-DDTHH:MM:SSZ` (RFC 3339). Example: `2026-03-01T23:59:59Z`
`sort`	string	No	Sort order for results. Possible values: `ASC` (ascending), `DESC` (descending). Example: `DESC`

Order statuses

Status	Description
pending	Order is waiting for payment to be completed
processing	Order is waiting for shipment
held	Order is on hold because it is being verified
complete	Order is complete, all items have been sent
canceled	Order canceled due to rejected payment
closed	Order is complete, all items have been returned

Sandbox

curl --location 'https://sandboxapi.g2a.com/export/v1/orders?orderId=92000000316793' \
--header 'Authorization: Bearer rfC3vIi6zoVqZSHAlhTXslTfvMZYwWPZ'

Success response (200)

Each order in data contains a transactions array. A transaction groups items sold by one seller and includes:

transaction id,
seller (id, name),
items (order lines with product, offer, quantity and prices).

Note: Fields discount, totalPrice, and each item's price and totalPrice are decimal strings in the order currency (currency).

{
  "data": [
    {
      "id": "92000000305593",
      "status": "complete",
      "createdAt": "2026-03-19T09:11:39Z",
      "discount": "0",
      "totalPrice": "112.17",
      "currency": "EUR",
      "transactions": [
        {
          "id": "fee9010d-e0cb-4f13-a712-3c84f964c167",
          "seller": {
            "id": "fe96c938-0550-47cd-a639-84c80e483573",
            "name": "Razer_gold"
          },
          "items": [
            {
              "id": "405332",
              "product": {
                "id": "10000017423002",
                "name": "Trials Evolution: Gold Edition Steam Key GLOBAL"
              },
              "offer": {
                "id": "cc3de0a1-b363-44f6-9e0f-0a401e8d5d47"
              },
              "quantity": {
                "ordered": 1,
                "invoiced": 1,
                "shipped": 1,
                "refunded": 0
              },
              "price": "112.17",
              "totalPrice": "112.17"
            }
          ]
        }
      ]
    },
    {
      "id": "92000000306503",
      "status": "complete",
      "createdAt": "2026-03-20T11:53:09Z",
      "discount": "0",
      "totalPrice": "58.84",
      "currency": "EUR",
      "transactions": [
        {
          "id": "9637f7ef-9bd8-4079-a620-20c4577350c3",
          "seller": {
            "id": "c2d4f6a8-b0c1-4234-9567-890123456789",
            "name": "KeysVendorEU"
          },
          "items": [
            {
              "id": "406419",
              "product": {
                "id": "10000003340014",
                "name": "Sherlock Holmes: Crimes and Punishments Steam Key CZECH REPUBLIC"
              },
              "offer": {
                "id": "83a7d4b9-64cc-4535-8a52-343b5aa8e94b"
              },
              "quantity": {
                "ordered": 1,
                "invoiced": 1,
                "shipped": 1,
                "refunded": 0
              },
              "price": "46.04",
              "totalPrice": "46.04"
            }
          ]
        },
        {
          "id": "1384984d-9314-4a34-b2be-d63d0f431989",
          "seller": {
            "id": "fe96c938-0550-47cd-a639-84c80e483573",
            "name": "Razer_gold"
          },
          "items": [
            {
              "id": "406421",
              "product": {
                "id": "10000017423002",
                "name": "Trials Evolution: Gold Edition Steam Key GLOBAL"
              },
              "offer": {
                "id": "cc3de0a1-b363-44f6-9e0f-0a401e8d5d47"
              },
              "quantity": {
                "ordered": 2,
                "invoiced": 2,
                "shipped": 2,
                "refunded": 0
              },
              "price": "6.40",
              "totalPrice": "12.80"
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "itemsPerPage": 4,
    "totalResults": 1112,
    "hasNext": true,
    "hasPrevious": false
  }
}

Field	Type	Description
`data`	array	List of orders history
`data[].id`	string	Order identifier
`data[].status`	string	Order status (pending, processing, complete, canceled, closed, held, pending_payment)
`data[].createdAt`	string	Order creation date in ISO 8601 format
`data[].discount`	string	Discount amount in `currency`
`data[].totalPrice`	string	Total order amount in `currency`
`data[].currency`	string	Order currency code (ISO 4217), e.g. USD, PLN, COP - all monetary strings on the row use this currency
`data[].transactions`	array	Transactions in the order
`data[].transactions[].id`	string	Transaction identifier
`data[].transactions[].seller`	object	Seller for transaction (`id` required; `name` when available)
`data[].transactions[].seller.id`	string	Seller identifier UUID
`data[].transactions[].seller.name`	string	Seller store name (may be omitted if not available)
`data[].transactions[].items`	array	Items in the transaction
`data[].transactions[].items[].id`	string	Order item identifier
`data[].transactions[].items[].product`	object	Product information
`data[].transactions[].items[].product.id`	string	Product identifier (e.g. `10000004439009`).
`data[].transactions[].items[].product.name`	string	Product name
`data[].transactions[].items[].offer`	object	Offer information
`data[].transactions[].items[].offer.id`	string	Offer identifier (UUID)
`data[].transactions[].items[].quantity`	object	Quantity information
`data[].transactions[].items[].quantity.ordered`	integer	Quantity ordered
`data[].transactions[].items[].quantity.invoiced`	integer	Quantity invoiced
`data[].transactions[].items[].quantity.shipped`	integer	Quantity shipped
`data[].transactions[].items[].quantity.refunded`	integer	Quantity refunded
`data[].transactions[].items[].price`	string	Unit price in `currency`
`data[].transactions[].items[].totalPrice`	string	Line total in `currency`
`meta`	object	Pagination metadata
`meta.page`	integer	Current page number
`meta.itemsPerPage`	integer	Number of items per page
`meta.totalResults`	integer	Total number of results
`meta.hasNext`	boolean	Whether there is a next page
`meta.hasPrevious`	boolean	Whether there is a previous page

Responses

Status	Description	Possible error codes
200	Success	Returns paginated list of user's orders with metadata
400	Bad request	`validation-error` — Invalid query parameters (e.g. invalid status, invalid date format, dateFrom after dateTo, missing required headers)
401	Unauthorized	`unauthorized` — Invalid or missing credentials, or the user could not be resolved for this request
500	Internal server error	`internal-server-error` — Failed to retrieve orders from the system

Headers​

Query parameters​

Order statuses​

Sandbox​

Success response (200)​

Responses​