Get a single tenant number by id
Authorization
bearerAuth Long-lived ES256 JWT minted from the dashboard (https://app.sautikit.com/developers/api-keys). Signed by the
platform keyring. Carries workspace_id and scopes claims;
revoked via the platform deny-list.
In: header
Path Parameters
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/v1/numbers/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9", "e164": "string", "friendly_name": "string", "status": "active", "assigned_at": "2019-08-24T14:15:22Z", "current_sip_credential_count": 0, "monthly_rental_anchor": "string"}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string" }}Claim an available inventory DID into the workspace POST
Server-side proration debits the workspace wallet for the remainder of the current billing month. Idempotency via the `Idempotency-Key` header (preferred) — the body's `idempotency_key` field is accepted for backwards compatibility but deprecated. If both are supplied, the header wins.
Release a tenant number DELETE
Marks the number released, returns the DID to the available pool, and emits a `number.released` event. Idempotent — re-releasing a released number returns 204 with no event.