---
title: "List own GMT wholesale orders"
method: GET
path: "/v1/purchases/bulk"
tags: ["Purchases"]
---

# List own GMT wholesale orders

`GET /v1/purchases/bulk`

## Request

- Base URL: `https://api.getmytg.com`
- URL: `https://api.getmytg.com/v1/purchases/bulk`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Paginated wholesale orders for the authenticated user. Use bulk_purchase_id with the status and archive download endpoints.

## Query parameters

- `page` integer: Page number.
- `page_size` integer: Number of items per page.
- `sort` 'date_asc' | 'date_desc': Sort purchases by creation date
- `status` 'PENDING' | 'SUCCESS' | 'ERROR' | 'REFUND' | 'EXPIRED': Legacy status projection: PENDING while the current retail code request is pending or failed, SUCCESS when its code is available. With include=code_request, status describes the durable purchase; code_request describes the current request. REFUND and access rules still apply.

## Response `200`

Response for status 200

- object
  - `items` object[], required
    - `bulk_purchase_id` integer, required: Unique ID of the bulk purchase request
    - `country_code` string, required: ISO 3166-1 alpha-2 country code.
    - `quantity` integer, required: Number of accounts in this purchase
    - `status` 'PENDING' | 'SUCCESS' | 'ERROR' | 'REFUND' | 'EXPIRED', required: Current status of bulk purchase
    - `created_at` string, required: Bulk purchase creation timestamp
    - `refunded_quantity` integer, required: Number of delivered accounts subsequently refunded. Any positive value revokes the entire original archive. Undelivered accounts compensated during export are excluded.
    - `total_price` object, nullable, required: Historical total, or null if it cannot be recovered.
      - `amount` string, required: Monetary amount as a string with up to 2 decimal places.
      - `currency_code` string, required: ISO 4217 currency code.
  - `pagination` object, required
    - `current_page` integer, required: Current page number.
    - `page_size` integer, required: Number of items per page.
    - `total_items` integer, required: Total number of items.
    - `total_pages` integer, required: Total number of pages.
    - `has_next` boolean, required: Whether there is a next page.
    - `has_previous` boolean, required: Whether there is a previous page.

## Other responses

- `400`: Response for status 400
- `401`: Response for status 401
- `403`: Response for status 403
- `429`: Response for status 429
- `500`: Internal server error
- `503`: Service unavailable

## Changes

- **2026-11-07** `6cc5398ec5d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmytg/apis/get-my-tg-api/changes/v1/purchases/bulk/get.md)

---

[API](https://skmtc.dev/getmytg/apis/get-my-tg-api.md) - [All operations](https://skmtc.dev/getmytg/apis/get-my-tg-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmytg/apis/get-my-tg-api/revisions/875ef52a8fe6?raw)