Sign inGet Started

Get an SMS sender

GET
/v1/sms/senders/{sender_id}
await bird.smsSenders.get("snd_01krdgeqcxet5s7t44vh8rt9mg");
Réponse200
{
  "id": "snd_01krdgeqcxet5s7t44vh8rt9mg",
  "source_kind": "number",
  "sender_type": "long_code",
  "country_code": "US",
  "number_id": "nda_01krdgeqcxet5s7t44vh8rt9mg",
  "status": "active",
  "next": [
    {
      "kind": "operation"
    }
  ],
  "destinations": {
    "active": [
      "US"
    ],
    "pending": [
      "US"
    ],
    "needs_attention": [
      "US"
    ]
  }
}

Returns one of your workspace's SMS senders with its per-country registration status.

Paramètres

sender_idstring

ID of the SMS sender (snd_ prefix), as returned when the sender was created.

Contenu de la réponse

id
string
obligatoire

Identifier of this sender.

sender
string
obligatoire

The value messages are sent from: a number in E.164 format, a shortcode, or an alphanumeric sender string.

source_kind
string
obligatoire
sender_type
string

The kind of sender identity this is, which decides what each destination country asks of it. It is finer than source_kind: a short code and an ordinary long code are both numbers but follow different rules.

country_code
nullable string

The country of the number this sender sends from. Null for an alphanumeric sender.

number_id
string

The number this sender sends from, as returned in the id field of GET /v1/numbers. Present only when source_kind is number or shared_number; an alphanumeric sender has no number behind it. Exactly one sender exists per number, so this is also how you go the other way: GET /v1/sms/senders?number_id={id} returns this sender.

status
string
obligatoire
next
array of object

What to do next about this sender, given the state it is in. Present on reads that compute it: an empty list means there is nothing to do, and the field is absent entirely on responses that do not report next actions.

This routes rather than advises. A sender only knows about itself, so where the work is per-country it names the requirements read rather than guessing which country you meant.

Afficher les attributs enfants
destinations
object
obligatoire
Afficher les attributs enfants
created_at
string
obligatoire
updated_at
string
obligatoire

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.