---
title: List
slug: redcircleapi/zipcodes-api/list
docTags: 
createdAt: 2024-07-27T14:22:43.825Z
---

# List Zipcodes

<font color="#52c41a">`GET`</font>  `/zipcodes`

To list zipcodes to your account you should make an  `HTTP GET`  request to the List Zipcodes endpoint. You can list zipcodes for a specific  `domain`  and perform a search using the  `search_term`  querystring parameter.

:::hint{type="info"}
**Zipcode Licensing**
To view how many zipcodes you can add to your account you can use the [Account API](https://docs.trajectdata.com/redcircleapi/account-api).
:::

Zipcodes can also be listed and edited visually via the [Dashboard](https://app.redcircleapi.com/zipcodes).

For more information about using zip & postal codes with RedCircle API please see the [zipcodes overview](https://docs.trajectdata.com/redcircleapi/zipcodes-api/overview).

***

### Parameters

The following querystring (HTTP GET) parameters allow you to refine the results returned by the List Zipcodes API.

| *`Parameter`*   | *`Required`*        | *`Description`*                                                                                                                                        |
| --------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *`api_key`*     | <u>*`required`*</u> | The API key for your account.                                                                                                                          |
| *`search_term`* | *`optional`*        | Limits the returned zipcodes to just those containing the `search_term` i.e. `search_term=455` (to return only zipcodes containing the string `455` ). |
| *`domain`*      | *`optional`*        | Filters the zipcodes returned to only those from the domain specified.                                                                                 |
| *`page`*        | *`optional`*        | The page of results to return. A maximum of 10 results are returned per page.                                                                          |

### Example

In the example below we List all the zipcodes on your account:

:::CodeblockTabs
```curl
$ curl "https://api.redcircleapi.com/zipcodes?api_key=demo"
```

```nodejs
const axios = require('axios');

axios.get('https://api.redcircleapi.com/zipcodes?api_key=demo')
.then(response => {
  const apiResponse = response.data;

  console.log("Zipcodes: ", JSON.stringify(apiResponse, 0, 2);

}).catch(error => {
  console.error(error);
});
```

```python
import requests
import json

params = {
  'api_key': 'demo'
}

api_result = requests.get('https://api.redcircleapi.com/zipcodes', { params })

api_response = api_result.json()

print "Zipcodes: ", json.dumps(api_response)
```

```php
<?php
      
$queryString = http_build_query([
  'api_key' => 'demo',
]);

$ch = curl_init('https://api.redcircleapi.com/zipcodes', $queryString);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
# the following options are required if you're using an outdated OpenSSL version
# more details: https://www.openssl.org/blog/blog/2021/09/13/LetsEncryptRootCertExpire/
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);

$json = curl_exec($ch);
curl_close($ch);

$api_result = json_decode($json, true);

print_r($api_result);

?>
```
:::

An example of a successful response to the List Zipcodes API is shown below:

```json
{
  "request_info": {
    "success": true
  },
  "usage": {
    "used": 2,
    "limit": 10,
    "available": 8
  },
  "zipcodes": {
    "target.com": [
      {
        "zipcode": "65534",
        "status": "preparing"
      }
    ]
  }
}
```

***

**Next Steps**
     [Zipcodes Overview](https://docs.trajectdata.com/redcircleapi/zipcodes-api/overview)
     [Deleting a zipcode via the Zipcodes API](https://docs.trajectdata.com/redcircleapi/zipcodes-api/delete)
     [Add a zipcode via the Zipcodes API](https://docs.trajectdata.com/redcircleapi/zipcodes-api/add)