GEgetmytg
Purchases

Get bulk purchase status

Changed on

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

get/v1/purchases/bulk/{purchase_id}

Request

  • Base URL
    https://api.getmytg.com
  • URL
    https://api.getmytg.com/v1/purchases/bulk/{purchase_id}
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

purchase_idinteger required

Unique purchase identifier.

Example:12345

Response

Response for status 200

bulk_purchase_idinteger required

Unique ID of the bulk purchase request

country_codestring required

ISO 3166-1 alpha-2 country code.

quantityinteger required

Number of accounts in this purchase

status'PENDING' | 'SUCCESS' | 'ERROR' | 'REFUND' | 'EXPIRED' required

Current status of bulk purchase

created_atstring required

Bulk purchase creation timestamp

updated_atstring required

Last update timestamp

Example response

{
  "bulk_purchase_id": 123,
  "total_price": {
    "amount": "1.50",
    "currency_code": "USD"
  },
  "price_per_account": {
    "amount": "1.50",
    "currency_code": "USD"
  },
  "item": {
    "export_id": "550e8400-e29b-41d4-a716-446655440000",
    "archive_url": "/v1/purchases/bulk/123/download",
    "quantity": 10,
    "created_at": "2024-11-19T08:15:00.000Z"
  }
}

Changes

  • aa3ff24cbee2Revision changes
    • breaking

      for the path request parameter purchase_id, the type changed from string to integer

    • warning

      for the path request parameter purchase_id, the max was set to 9007199254740991.00

    • warning

      for the path request parameter purchase_id, the min was set to 1.00

    • warning

      added the new EXPIRED enum value to the / response property for the response status

    • warning

      added the new EXPIRED enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status