Retrieve a phone number▾
GET

Retrieve a phone number

Fetch one number's status, quality rating and messaging tier.

Accepts the Sendport id (pn_…) or the number itself in E.164.

GET/v1/numbers/{id}

Path parameters

idstringrequired

pn_… or +15550100200.

curl -X GET https://api.sendport.tech/v1/numbers/{id} \
  -H "Authorization: Bearer $SENDPORT_KEY"

Responses

200OK
{
  "object": "phone_number",
  "id": "pn_01JZQ2E5R7T9V1X3Z5B7D9FHKM",
  "display_number": "+15550100200",
  "verified_name": "Sendport Demo",
  "quality_rating": "GREEN",
  "messaging_limit": "TIER_100K",
  "status": "CONNECTED",
  "waba_id": "104857612345678",
  "connected_at": "2026-04-11T12:00:00.000Z"
}
401Unauthorized
{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No API key provided.",
    "doc_url": "https://sendport.tech/docs/errors#missing_api_key",
    "request_id": "req_9f3c2a7b41de08c5b2e6"
  }
}
Try itsandbox
PreviousList phone numbersNextWebhooks