Skip to main content
Use this endpoint before POST /api/v1/chats. Pass one returned phone_number as the from value. Use phone_line_id when an endpoint lets you pin a send to a specific sender line.

​
Request

curl https://console.trychert.com/api/v1/phone-numbers \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET"

​
Response

{
  "phone_numbers": [
    {
      "id": "pl_01H...",
      "phone_line_id": "pl_01H...",
      "phone_number": "+15555550100",
      "service": "imessage",
      "is_active": true,
      "capabilities": ["imessage", "send", "receive"]
    }
  ]
}

​
Fields

FieldMeaning
idStable Chert phone-line id. Same value as phone_line_id.
phone_line_idUse this with request fields named phone_line_id.
phone_numberE.164 sender number. Use this as from in Chats.
serviceCurrently imessage for Chert-managed sends.
is_activeWhether the number can currently participate in messaging.
capabilitiessend, receive, imessage, and future service flags.
Chert pins a sender line after the first successful conversation with a recipient. Follow-ups reuse that line automatically.

​
See also