Channelsv4

Get purchase status

GET/channels/blooio/purchases/{purchaseId}

Poll the status of an asynchronous number purchase by its purchase_id. Returns pending/provisioning, completed (with the provisioned allocations), or failed. Requires the numbers:read scope for OAuth apps.

Path parameters

purchaseIdRequiredstring

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalobject

purchase_idoptionalstring

statusoptionalstring

allocationsoptionalobject[]

Response codes

200Purchase status

401Your API key is missing or invalid. Pass it as a bearer token.

403Your API key isn't allowed to access this channel (blocked key or plan limit).

404No channel was found with the provided `purchaseId`.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X GET https://api.blooio.com/v4/channels/blooio/purchases/obj_a1b2c3d4 \

  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": {    "purchase_id": "obj_a1b2c3d4",    "status": "active",    "allocations": [      {}    ]  }}