Skip to main content
GET
List your active and reserved lines
  • Credential: an API key.
  • Line-scoped keys: a line-scoped key gets only the lines of its list.
  • Events: none.
  • Personal data: phone_number, the full number of each line, and metadata. Request it only when needed, do not copy it into logs, tickets or other tools, and refer to a contact by an id of your own.
  • What is listed: your active and reserved lines of every kind, shared and test lines included, oldest first, with full phone numbers. Lines whose status is suspended, provisioning or cancelled are left out: keep the ids of your lines. See Your lines.
  • Pagination: none, and no filter. The API does not bound the number of lines in the response.

Errors

This operation has no error of its own. The errors that every operation shares are in Errors.

Authorizations

Authorization
string
header
required

An API key created in the iSnap dashboard, or a trial key, sent as Authorization: Bearer <key>. An API key starts with isnap_live_ or isnap_test_; both act on the same account, lines and billing. A trial key acts on its trial only.

Response

Your active and reserved lines.

success
enum<boolean>
required

Always true on a success response.

Available options:
true
data
object
required

The lines of your account that are active or reserved.

trace_id
string
required

Trace id of the request that produced this response: 32 lowercase hexadecimal characters. Quote it when you report a problem to iSnap.

request_id
string
required

Id of the request that produced this response: req_ followed by 25 letters or digits.