# Get NANPA Prefixes

Returns a collection of NANPA Prefixes.

## Request

HTTP Method: `GET`

URI Path: `/v3/nanpa_prefixes`

Note

For all returned data attributes, see [Nanpa Prefixes Object](nanpa-prefixes-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string`, `boolean` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[nanpa\_prefixes] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |
| page[number] | `integer` | No | [Page number](../../../specification/pagination.html#api-pagination). |
| page[size] | `integer` | No | [Page size](../../../specification/pagination.html#api-pagination). Pagination defaults to `50` records per page. The maximum is `100`. |

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../countries/country-object.html#country-object-v35) |
| region | [Region Object](../regions/region-object.html#region-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | NANPA Prefixes `id` field. |
| npa | `string` | Yes | Yes | NANPA Prefixes `npa` field. |
| nxx | `string` | Yes | Yes | NANPA Prefixes `nxx` field. |
| npanxx | `string` | No | No | NANPA Prefixes `npa` / `nxx` fields. |
| country.id | `string` | Yes | Yes | A `country.id` field. |
| region.id | `string` | Yes | Yes | A `region.id` field. |
| did\_group.is\_available | `boolean` | No | No | Availability of DIDs in stock for prefix. |
| did\_group.features | `string` | No | Yes | Availability of DIDs in stock with features for prefix. Can be one or several of `voice_in`, `voice_out`, `t38`, `sms_in`, `p2p`, `a2p`, `emergency`, and `cnam_out`. Example: `voice_in,sms_in`. |

### Sorting

| Value | Sorts by: |
| --- | --- |
| npa | NANPA Prefixes `npa` field. |
| nxx | NANPA Prefixes `nxx` field. |

## Examples

GET NANPA PrefixesFilter by US country.idInclude Country Resource

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/nanpa_prefixes HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/nanpa_prefixes -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
  1HTTP/2 200 OK
  2Content-Type: application/vnd.api+json
  3
  4 {
  5     "data": [
  6         {
  7             "id": "1d968dcf-8ee7-40fa-8073-cdbc027bc3b3",
  8             "type": "nanpa_prefixes",
  9             "attributes": {
 10                 "npa": "201",
 11                 "nxx": "221"
 12             },
 13             "relationships": {
 14                 "country": {
 15                     "links": {
 16                         "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/country",
 17                         "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/country"
 18                     }
 19                 },
 20                 "region": {
 21                     "links": {
 22                         "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/region",
 23                         "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/region"
 24                     }
 25                 }
 26             }
 27         },
 28         {
 29             "id": "c8770990-8a6f-4e11-8b88-420cc9375931",
 30             "type": "nanpa_prefixes",
 31             "attributes": {
 32                 "npa": "201",
 33                 "nxx": "234"
 34             },
 35             "relationships": {
 36                 "country": {
 37                     "links": {
 38                         "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/country",
 39                         "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/country"
 40                     }
 41                 },
 42                 "region": {
 43                     "links": {
 44                         "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/region",
 45                         "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/region"
 46                     }
 47                 }
 48             }
 49         },
 50         {
 51             "id": "a5958064-96d7-4594-b9bc-a5b9c3bba01f",
 52             "type": "nanpa_prefixes",
 53             "attributes": {
 54                 "npa": "201",
 55                 "nxx": "275"
 56             },
 57             "relationships": {
 58                 "country": {
 59                     "links": {
 60                         "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/country",
 61                         "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/country"
 62                     }
 63                 },
 64                 "region": {
 65                     "links": {
 66                         "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/region",
 67                         "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/region"
 68                     }
 69                 }
 70             }
 71         },
 72         {
 73             "id": "fcd178f8-3085-42c2-9831-7ca30fc01789",
 74             "type": "nanpa_prefixes",
 75             "attributes": {
 76                 "npa": "201",
 77                 "nxx": "301"
 78             },
 79             "relationships": {
 80                 "country": {
 81                     "links": {
 82                         "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/country",
 83                         "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/country"
 84                     }
 85                 },
 86                 "region": {
 87                     "links": {
 88                         "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/region",
 89                         "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/region"
 90                     }
 91                 }
 92             }
 93         },
 94         {
 95             "id": "1ff532b2-fec0-4f13-b661-d688ac29dfb0",
 96             "type": "nanpa_prefixes",
 97             "attributes": {
 98                 "npa": "201",
 99                 "nxx": "345"
100             },
101             "relationships": {
102                 "country": {
103                     "links": {
104                         "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/country",
105                         "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/country"
106                     }
107                 },
108                 "region": {
109                     "links": {
110                         "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/region",
111                         "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/region"
112                     }
113                 }
114             }
115         }
116     ],
117     "meta": {
118         "total_records": 4330,
119         "api_version": "2026-11-19"
120     },
121     "links": {
122         "first": "https://api.didww.com/v3/nanpa_prefixes?page%5Bnumber%5D=1&page%5Bsize%5D=5",
123         "next": "https://api.didww.com/v3/nanpa_prefixes?page%5Bnumber%5D=2&page%5Bsize%5D=5",
124         "last": "https://api.didww.com/v3/nanpa_prefixes?page%5Bnumber%5D=866&page%5Bsize%5D=5"
125     }
126 }
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/nanpa_prefixes?filter%5Bcountry.id%5D=1f6fc2bd-f081-4202-9b1a-d9cb88d942b9 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/nanpa_prefixes?filter%5Bcountry.id%5D=1f6fc2bd-f081-4202-9b1a-d9cb88d942b9' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5    "data": [
  6        {
  7            "id": "1d968dcf-8ee7-40fa-8073-cdbc027bc3b3",
  8            "type": "nanpa_prefixes",
  9            "attributes": {
 10                "npa": "201",
 11                "nxx": "221"
 12            },
 13            "relationships": {
 14                "country": {
 15                    "links": {
 16                        "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/country",
 17                        "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/country"
 18                    }
 19                },
 20                "region": {
 21                    "links": {
 22                        "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/region",
 23                        "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/region"
 24                    }
 25                }
 26            }
 27        },
 28        {
 29            "id": "c8770990-8a6f-4e11-8b88-420cc9375931",
 30            "type": "nanpa_prefixes",
 31            "attributes": {
 32                "npa": "201",
 33                "nxx": "234"
 34            },
 35            "relationships": {
 36                "country": {
 37                    "links": {
 38                        "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/country",
 39                        "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/country"
 40                    }
 41                },
 42                "region": {
 43                    "links": {
 44                        "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/region",
 45                        "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/region"
 46                    }
 47                }
 48            }
 49        },
 50        {
 51            "id": "a5958064-96d7-4594-b9bc-a5b9c3bba01f",
 52            "type": "nanpa_prefixes",
 53            "attributes": {
 54                "npa": "201",
 55                "nxx": "275"
 56            },
 57            "relationships": {
 58                "country": {
 59                    "links": {
 60                        "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/country",
 61                        "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/country"
 62                    }
 63                },
 64                "region": {
 65                    "links": {
 66                        "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/region",
 67                        "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/region"
 68                    }
 69                }
 70            }
 71        },
 72        {
 73            "id": "fcd178f8-3085-42c2-9831-7ca30fc01789",
 74            "type": "nanpa_prefixes",
 75            "attributes": {
 76                "npa": "201",
 77                "nxx": "301"
 78            },
 79            "relationships": {
 80                "country": {
 81                    "links": {
 82                        "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/country",
 83                        "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/country"
 84                    }
 85                },
 86                "region": {
 87                    "links": {
 88                        "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/region",
 89                        "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/region"
 90                    }
 91                }
 92            }
 93        },
 94        {
 95            "id": "1ff532b2-fec0-4f13-b661-d688ac29dfb0",
 96            "type": "nanpa_prefixes",
 97            "attributes": {
 98                "npa": "201",
 99                "nxx": "345"
100            },
101            "relationships": {
102                "country": {
103                    "links": {
104                        "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/country",
105                        "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/country"
106                    }
107                },
108                "region": {
109                    "links": {
110                        "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/region",
111                        "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/region"
112                    }
113                }
114            }
115        }
116    ],
117    "meta": {
118        "total_records": 1609,
119        "api_version": "2026-11-19"
120    },
121    "links": {
122        "first": "https://api.didww.com/v3/nanpa_prefixes?filter%5Bcountry.id%5D=1f6fc2bd-f081-4202-9b1a-d9cb88d942b9&page%5Bnumber%5D=1&page%5Bsize%5D=5",
123        "next": "https://api.didww.com/v3/nanpa_prefixes?filter%5Bcountry.id%5D=1f6fc2bd-f081-4202-9b1a-d9cb88d942b9&page%5Bnumber%5D=2&page%5Bsize%5D=5",
124        "last": "https://api.didww.com/v3/nanpa_prefixes?filter%5Bcountry.id%5D=1f6fc2bd-f081-4202-9b1a-d9cb88d942b9&page%5Bnumber%5D=322&page%5Bsize%5D=5"
125    }
126}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/nanpa_prefixes?include=country HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/nanpa_prefixes?include=country' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5    "data": [
  6        {
  7            "id": "1d968dcf-8ee7-40fa-8073-cdbc027bc3b3",
  8            "type": "nanpa_prefixes",
  9            "attributes": {
 10                "npa": "201",
 11                "nxx": "221"
 12            },
 13            "relationships": {
 14                "country": {
 15                    "links": {
 16                        "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/country",
 17                        "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/country"
 18                    },
 19                    "data": {
 20                        "type": "countries",
 21                        "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
 22                    }
 23                },
 24                "region": {
 25                    "links": {
 26                        "self": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/relationships/region",
 27                        "related": "https://api.didww.com/v3/nanpa_prefixes/1d968dcf-8ee7-40fa-8073-cdbc027bc3b3/region"
 28                    }
 29                }
 30            }
 31        },
 32        {
 33            "id": "c8770990-8a6f-4e11-8b88-420cc9375931",
 34            "type": "nanpa_prefixes",
 35            "attributes": {
 36                "npa": "201",
 37                "nxx": "234"
 38            },
 39            "relationships": {
 40                "country": {
 41                    "links": {
 42                        "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/country",
 43                        "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/country"
 44                    },
 45                    "data": {
 46                        "type": "countries",
 47                        "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
 48                    }
 49                },
 50                "region": {
 51                    "links": {
 52                        "self": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/relationships/region",
 53                        "related": "https://api.didww.com/v3/nanpa_prefixes/c8770990-8a6f-4e11-8b88-420cc9375931/region"
 54                    }
 55                }
 56            }
 57        },
 58        {
 59            "id": "a5958064-96d7-4594-b9bc-a5b9c3bba01f",
 60            "type": "nanpa_prefixes",
 61            "attributes": {
 62                "npa": "201",
 63                "nxx": "275"
 64            },
 65            "relationships": {
 66                "country": {
 67                    "links": {
 68                        "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/country",
 69                        "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/country"
 70                    },
 71                    "data": {
 72                        "type": "countries",
 73                        "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
 74                    }
 75                },
 76                "region": {
 77                    "links": {
 78                        "self": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/relationships/region",
 79                        "related": "https://api.didww.com/v3/nanpa_prefixes/a5958064-96d7-4594-b9bc-a5b9c3bba01f/region"
 80                    }
 81                }
 82            }
 83        },
 84        {
 85            "id": "fcd178f8-3085-42c2-9831-7ca30fc01789",
 86            "type": "nanpa_prefixes",
 87            "attributes": {
 88                "npa": "201",
 89                "nxx": "301"
 90            },
 91            "relationships": {
 92                "country": {
 93                    "links": {
 94                        "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/country",
 95                        "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/country"
 96                    },
 97                    "data": {
 98                        "type": "countries",
 99                        "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
100                    }
101                },
102                "region": {
103                    "links": {
104                        "self": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/relationships/region",
105                        "related": "https://api.didww.com/v3/nanpa_prefixes/fcd178f8-3085-42c2-9831-7ca30fc01789/region"
106                    }
107                }
108            }
109        },
110        {
111            "id": "1ff532b2-fec0-4f13-b661-d688ac29dfb0",
112            "type": "nanpa_prefixes",
113            "attributes": {
114                "npa": "201",
115                "nxx": "345"
116            },
117            "relationships": {
118                "country": {
119                    "links": {
120                        "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/country",
121                        "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/country"
122                    },
123                    "data": {
124                        "type": "countries",
125                        "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9"
126                    }
127                },
128                "region": {
129                    "links": {
130                        "self": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/relationships/region",
131                        "related": "https://api.didww.com/v3/nanpa_prefixes/1ff532b2-fec0-4f13-b661-d688ac29dfb0/region"
132                    }
133                }
134            }
135        }
136    ],
137    "included": [
138        {
139            "id": "1f6fc2bd-f081-4202-9b1a-d9cb88d942b9",
140            "type": "countries",
141            "attributes": {
142                "name": "United States",
143                "prefix": "1",
144                "iso": "US"
145            },
146            "relationships": {
147                "regions": {
148                    "links": {
149                        "self": "https://api.didww.com/v3/countries/1f6fc2bd-f081-4202-9b1a-d9cb88d942b9/relationships/regions",
150                        "related": "https://api.didww.com/v3/countries/1f6fc2bd-f081-4202-9b1a-d9cb88d942b9/regions"
151                    }
152                }
153            }
154        }
155    ],
156    "meta": {
157        "total_records": 4330,
158        "api_version": "2026-11-19"
159    },
160    "links": {
161        "first": "https://api.didww.com/v3/nanpa_prefixes?include=country&page%5Bnumber%5D=1&page%5Bsize%5D=5",
162        "next": "https://api.didww.com/v3/nanpa_prefixes?include=country&page%5Bnumber%5D=2&page%5Bsize%5D=5",
163        "last": "https://api.didww.com/v3/nanpa_prefixes?include=country&page%5Bnumber%5D=866&page%5Bsize%5D=5"
164    }
165}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 429 | No | The request budget of the account for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
