---
title: "Get bulk purchase status"
method: GET
path: "/v1/purchases/bulk/{purchase_id}"
tags: ["Purchases"]
---

# Get bulk purchase status

`GET /v1/purchases/bulk/{purchase_id}`

Returns the status of a bulk purchase, including details and link to download archive.

## Path parameters

- `purchase_id` string, required

## Response `200`

Response for status 200

- object
  - `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
  - `total_price` object, required — Total price for all accounts
    - `amount` string, required — Monetary amount as a string with up to 2 decimal places.
    - `currency_code` string, required — ISO 4217 currency code.
  - `price_per_account` object, required — Price of a single account
    - `amount` string, required — Monetary amount as a string with up to 2 decimal places.
    - `currency_code` string, required — ISO 4217 currency code.
  - `item` object, nullable, required — Archive data (only populated when status is SUCCESS)
    - `export_id` string, required — Archive/export ID with sessions
    - `archive_url` string, required — Path or URL to download the archive with accounts
    - `quantity` integer, required — Number of accounts in the archive
    - `status` 'PENDING' | 'SUCCESS' | 'ERROR' | 'REFUND', required — Status of bulk purchase
    - `created_at` string, required — Bulk purchase creation timestamp
  - `status` 'PENDING' | 'SUCCESS' | 'ERROR' | 'REFUND', required — Current status of bulk purchase
  - `created_at` string, required — Bulk purchase creation timestamp
  - `updated_at` string, required — Last update timestamp

---

[API](https://skmtc.net/getmytg/apis/get-my-tg-api.md) · [All operations](https://skmtc.net/getmytg/apis/get-my-tg-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmytg/get-my-tg-api/revisions/30f975c0d1e6/schema)