Get rate center by number

GET 
/geo/supplemental

Lookup rate centers that contain a number that match a npa, nxx pair. Wildcards as (*) may be used for nxx.

Requires an authorization header or IP Auth setup through the portal.

Request

Query Parameters

npa stringrequired

npa

nxx stringrequired

nxx

Responses

200: Success. The response will be an array of RatecenterResults or the NoResults object.

application/json

• Schema
• Example (from schema)

Schema

• Array [

rc_name string

Ratecenter name

rc_abbre string

Ratecenter abbreviation

state string

State

npa_nxx

object[]

Array [

npa string

nxx string

]

• ]

[
  {
    "rc_name": "string",
    "rc_abbre": "string",
    "state": "string",
    "npa_nxx": [
      {
        "npa": "string",
        "nxx": "string"
      }
    ]
  }
]

400: Bad request when missing query parameter or query length is less than three characters

application/json

• Schema
• Example (from schema)

Schema

success string

"false"

message string

you must provide both NPA and NXX parameters to do this type of lookup; NPA and NXX must both be 3-digit numbers, * wildcards are allowed"

reasons string[]

{
  "success": "string",
  "message": "string",
  "reasons": [
    "string"
  ]
}

401: Unauthorized request

application/json

• Schema
• Example (from schema)

Schema

error string

Unauthorized request

{
  "error": "string"
}

Request samples

• cURL

---

curl -L 'https://switchdata.telnyx.com/v1/geo/supplemental' \
-H 'Accept: application/json'

Response samples

• 200
• 400
• 401

---

[
  {
    "rc_name": "string",
    "rc_abbre": "string",
    "state": "string",
    "npa_nxx": [
      {
        "npa": "string",
        "nxx": "string"
      }
    ]
  }
]

{
  "success": "string",
  "message": "string",
  "reasons": [
    "string"
  ]
}

{
  "error": "string"
}