# Get Emergency Verifications

Returns the emergency verifications status and reason if the verification was rejected.

## Request

HTTP Method: `GET`

URI Path: `/v3/emergency_verifications`

Note

For all returned data attributes, see [Emergency Verification Object](emergency-verification-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[emergency\_verifications] | `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 |
| --- | --- |
| address | [Addresses Object](../../regulation-resources/addresses/address-object.html#addresses-object-v35) |
| emergency\_calling\_service | [Emergency Calling Service Object](../emergency-calling-services/emergency-calling-service-object.html#emergency-calling-service-object-v35) |
| dids | [DID Object](../../inventory-resources/did/did-object.html#did-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | The `id` field. |
| status | `string` | No | No | The `status` field. Possible values: `pending`, `approved`, `rejected`. |
| emergency\_calling\_service.id | `string` | No | Yes | The `emergency_calling_service.id` field. |
| external\_reference\_id | `string` | Yes | No | The `external_reference_id` field. |

### Sorting

| Value | Sorts by: |
| --- | --- |
| created\_at | The `created_at` field. |
| external\_reference\_id | The `external_reference_id` field. |

## Examples

Simple RequestFilter by statusInclude emergency\_calling\_service

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/emergency_verifications 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/emergency_verifications -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": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
 8            "type": "emergency_verifications",
 9            "attributes": {
10                "reference": "SHB-485120",
11                "status": "pending",
12                "reject_reasons": null,
13                "reject_comment": null,
14                "callback_url": "https://example.com/callbacks/emergency",
15                "callback_method": "post",
16                "created_at": "2026-03-20T12:20:04.584Z",
17                "external_reference_id": null
18            },
19            "relationships": {
20                "address": {
21                    "links": {
22                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
23                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
24                    }
25                },
26                "emergency_calling_service": {
27                    "links": {
28                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
29                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
30                    }
31                },
32                "dids": {
33                    "links": {
34                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
35                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
36                    }
37                }
38            }
39        },
40        {
41            "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
42            "type": "emergency_verifications",
43            "attributes": {
44                "reference": "SHB-991234",
45                "status": "approved",
46                "reject_reasons": null,
47                "reject_comment": null,
48                "callback_url": null,
49                "callback_method": null,
50                "created_at": "2026-01-10T09:00:00.000Z",
51                "external_reference_id": null
52            },
53            "relationships": {
54                "address": {
55                    "links": {
56                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
57                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
58                    }
59                },
60                "emergency_calling_service": {
61                    "links": {
62                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/emergency_calling_service",
63                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/emergency_calling_service"
64                    }
65                },
66                "dids": {
67                    "links": {
68                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
69                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
70                    }
71                }
72            }
73        }
74    ],
75    "meta": {
76        "total_records": 2,
77        "api_version": "2026-11-19"
78    },
79    "links": {
80        "first": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
81        "last": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
82    }
83}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/emergency_verifications?filter%5Bstatus%5D=pending 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/emergency_verifications?filter%5Bstatus%5D=pending' -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": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
 8            "type": "emergency_verifications",
 9            "attributes": {
10                "reference": "SHB-485120",
11                "status": "pending",
12                "reject_reasons": null,
13                "reject_comment": null,
14                "callback_url": "https://example.com/callbacks/emergency",
15                "callback_method": "post",
16                "created_at": "2026-03-20T12:20:04.584Z",
17                "external_reference_id": null
18            },
19            "relationships": {
20                "address": {
21                    "links": {
22                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
23                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
24                    }
25                },
26                "emergency_calling_service": {
27                    "links": {
28                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
29                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
30                    }
31                },
32                "dids": {
33                    "links": {
34                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
35                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
36                    }
37                }
38            }
39        }
40    ],
41    "meta": {
42        "total_records": 1,
43        "api_version": "2026-11-19"
44    },
45    "links": {
46        "first": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&page%5Bnumber%5D=1&page%5Bsize%5D=50",
47        "last": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&page%5Bnumber%5D=1&page%5Bsize%5D=50"
48    }
49}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service 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/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service' -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": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
  8            "type": "emergency_verifications",
  9            "attributes": {
 10                "reference": "SHB-485120",
 11                "status": "pending",
 12                "reject_reasons": null,
 13                "reject_comment": null,
 14                "callback_url": "https://example.com/callbacks/emergency",
 15                "callback_method": "post",
 16                "created_at": "2026-03-20T12:20:04.584Z",
 17                "external_reference_id": null
 18            },
 19            "relationships": {
 20                "address": {
 21                    "links": {
 22                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
 23                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
 24                    }
 25                },
 26                "emergency_calling_service": {
 27                    "links": {
 28                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
 29                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
 30                    },
 31                    "data": {
 32                        "type": "emergency_calling_services",
 33                        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 34                    }
 35                },
 36                "dids": {
 37                    "links": {
 38                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
 39                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
 40                    }
 41                }
 42            }
 43        }
 44    ],
 45    "included": [
 46        {
 47            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 48            "type": "emergency_calling_services",
 49            "attributes": {
 50                "number_type": "local",
 51                "name": "E911 Service - New York Office",
 52                "reference": "SHB-485120",
 53                "status": "in_process",
 54                "activated_at": null,
 55                "canceled_at": null,
 56                "renew_date": null,
 57                "created_at": "2026-03-20T12:20:00.000Z"
 58            },
 59            "relationships": {
 60                "country": {
 61                    "links": {
 62                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
 63                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
 64                    }
 65                },
 66                "order": {
 67                    "links": {
 68                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
 69                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
 70                    }
 71                },
 72                "emergency_requirement": {
 73                    "links": {
 74                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
 75                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
 76                    }
 77                },
 78                "emergency_verification": {
 79                    "links": {
 80                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
 81                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
 82                    }
 83                },
 84                "dids": {
 85                    "links": {
 86                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
 87                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
 88                    }
 89                }
 90            },
 91            "meta": {
 92                "setup_price": "0.0",
 93                "monthly_price": "2.5"
 94            }
 95        }
 96    ],
 97    "meta": {
 98        "total_records": 1,
 99        "api_version": "2026-11-19"
100    },
101    "links": {
102        "first": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50",
103        "last": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50"
104    }
105}
```

[[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) |
| 403 | No | Forbidden. Emergency calling is not enabled for the account. |
| 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. |
