> For the complete documentation index, see [llms.txt](https://apidocs.api19.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.api19.com/numbers-ordering/list-areas.md).

# List Areas

## GET Request

{% hint style="info" %}
<https://v1.api19.com/dids/ratecenters/list?key=yourkey>
{% endhint %}

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.

{% tabs %}
{% tab title="Curl POST" %}

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

{% endtab %}

{% tab title="Curl GET" %}

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

{% endtab %}

{% tab title="JSON Response" %}

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

{% endtab %}

{% tab title="Error Responses" %}

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

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

{% endtab %}
{% endtabs %}