List Areas

List all Ratecenter/Cities and States

GET Request

https://v1.api19.com/dids/ratecenters/list?key=yourkey

To retrieve rate center information, submit a GET or POST request using your API key. The API key may be provided either as a URL parameter (key) or via HTTP Basic Authentication.

The API response includes both the city name and rate center information, allowing you to work with human-readable location data. For example, the rate center code LSAN DA 01 corresponds to Los Angeles, CA.

To obtain a list of rate centers for a specific state, send a GET or POST request to the endpoint above and include the following parameter:

state=[state_abbreviation]

Example: state=CA

The API will return all available rate centers associated with the specified state.

Curl POST

curl -X POST https://v1.api19.com/dids/ratecenters/list \
 -d 'key=your-api-key'

Curl GET

curl "https://v1.api19.com/dids/ratecenters/list?key=yourkey"

JSON Response

{
    "status": "ok",
    "data": [
        {
            "ratecenter": "DENVER",
            "city": "Denver",
            "state": "CO"
        },
        {
            "ratecenter": "DALLAS",
            "city": "Dallas",
            "state": "TX"
        }
    ]
}

Error Responses

[
    'status' => 'error', 
    'error' => 'System error', 
    'code' => 'system_error' 
]

[
    'status' => 'error',
    'error' => 'Invalid state. State must be a 2-character abbreviation.' 
    'code' => 'invalid_state'
]