Skip to main content
GET
List the lines that need attention
  • Credential: an API key.
  • Line-scoped keys: a line-scoped key gets only the entries of the lines in its list.
  • Events: none.
  • Personal data: phone_number, the full number of each listed line. 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: one entry per line that has a fault. A BYOD line is listed as soon as the fault is seen, with its reasons. Any other line is listed once the fault has lasted 15 minutes, with reasons: [] and detail_withheld: true: write to support@isnap.ai with the line_id to report it. The meaning of each reason is in Attention.
  • What is not listed: a suspended line is not listed for its suspension. Read each rented or BYOD line whose id you keep with GET /v1/lines/{id} to see its status.
  • Pagination: none. The API does not bound the number of entries.
  • SDK: the SDK has no method for this operation. Call it with client.request('GET', '/v1/attention').

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

The lines that have a fault now, oldest fault first.

success
enum<boolean>
required

Always true on a success response.

Available options:
true
data
object
required

Your lines that have a fault now.

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.