Creates a new wholesale purchase for the specified country. Immediately debits the balance and returns the purchase with the status “PENDING”.
Wholesale purchase creation process
Webhook notification. Optionally provide callback_url to receive a webhook when the archive is ready.
Next steps. Call “GET /bulk/:purchaseId” to get the account archive link.
API-key that you received from Telegram Bot.
ISO 3166-1 alpha-2 country code.
^[A-Z]{2}$"US"
Number of accounts to purchase
1 <= x <= 900719925474099110
URL to receive webhook notification when bulk archive is ready. POST request will be sent with WebhookBulkReadyPayload.
Retry policy. If your endpoint does not return HTTP 200, webhook will be retried up to 3 times with delays: immediately, after 10 seconds, after 30 seconds. Any non-200 response triggers retry.
"https://example.com/webhooks/code-received"
Response for status 200
Unique ID of the bulk purchase request
1 <= x <= 9007199254740991123
ISO 3166-1 alpha-2 country code.
Number of accounts in this purchase
1 <= x <= 9007199254740991Total price for all accounts
Price of a single account
Archive data (only populated when status is SUCCESS)
Current status of bulk purchase
PENDING, SUCCESS, ERROR, REFUND Bulk purchase creation timestamp
Last update timestamp