# 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) |

### Includes

| Value | Description |
| --- | --- |
| address | [Addresses Object](../../regulation-resources/addresses/address-object.html#addresses-object-v34) |
| emergency\_calling\_service | [Emergency Calling Service Object](../emergency-calling-services/emergency-calling-service-object.html#emergency-calling-service-object-v34) |
| dids | [DID Object](../../inventory-resources/did/did-object.html#did-object-v34) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| status | `string` | No | No | The `status` field. Possible values: `pending`, `approved`, `rejected`. |
| emergency\_calling\_service.id | `string` | No | No | 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

```
GET /v3/emergency_verifications HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET https://api.didww.com/v3/emergency_verifications -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": [
        {
            "id": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
            "type": "emergency_verifications",
            "attributes": {
                "reference": "SHB-485120",
                "status": "pending",
                "reject_reasons": [],
                "reject_comment": null,
                "callback_url": "https://example.com/callbacks/emergency",
                "callback_method": "post",
                "created_at": "2026-03-20T12:20:04.584Z",
                "external_reference_id": null
            },
            "relationships": {
                "address": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
                    }
                },
                "emergency_calling_service": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
                    }
                }
            }
        },
        {
            "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
            "type": "emergency_verifications",
            "attributes": {
                "reference": "SHB-991234",
                "status": "approved",
                "reject_reasons": [],
                "reject_comment": null,
                "callback_url": null,
                "callback_method": null,
                "created_at": "2026-01-10T09:00:00.000Z",
                "external_reference_id": null
            },
            "relationships": {
                "address": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
                    }
                },
                "emergency_calling_service": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/emergency_calling_service",
                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/emergency_calling_service"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
                    }
                }
            }
        }
    ],
    "meta": {
        "total_records": 2,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/emergency_verifications?filter%5Bstatus%5D=pending HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET 'https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": [
        {
            "id": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
            "type": "emergency_verifications",
            "attributes": {
                "reference": "SHB-485120",
                "status": "pending",
                "reject_reasons": [],
                "reject_comment": null,
                "callback_url": "https://example.com/callbacks/emergency",
                "callback_method": "post",
                "created_at": "2026-03-20T12:20:04.584Z",
                "external_reference_id": null
            },
            "relationships": {
                "address": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
                    }
                },
                "emergency_calling_service": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
                    }
                }
            }
        }
    ],
    "meta": {
        "total_records": 1,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -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 "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": [
        {
            "id": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
            "type": "emergency_verifications",
            "attributes": {
                "reference": "SHB-485120",
                "status": "pending",
                "reject_reasons": [],
                "reject_comment": null,
                "callback_url": "https://example.com/callbacks/emergency",
                "callback_method": "post",
                "created_at": "2026-03-20T12:20:04.584Z",
                "external_reference_id": null
            },
            "relationships": {
                "address": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
                    }
                },
                "emergency_calling_service": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
                    },
                    "data": {
                        "type": "emergency_calling_services",
                        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
                    }
                }
            }
        }
    ],
    "included": [
        {
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "type": "emergency_calling_services",
            "attributes": {
                "name": "E911 Service - New York Office",
                "reference": "SHB-485120",
                "status": "in_process",
                "activated_at": null,
                "canceled_at": null,
                "renew_date": null,
                "created_at": "2026-03-20T12:20:00.000Z"
            },
            "relationships": {
                "country": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
                    }
                },
                "did_group_type": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/did_group_type",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/did_group_type"
                    }
                },
                "order": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
                    }
                },
                "emergency_requirement": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
                    }
                },
                "emergency_verification": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
                    }
                }
            },
            "meta": {
                "setup_price": "0.0",
                "monthly_price": "2.5"
            }
        }
    ],
    "meta": {
        "total_records": 1,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/emergency_verifications?filter%5Bstatus%5D=pending&include=emergency_calling_service&page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |
| 400 | No | Invalid resource for earlier API versions. |

On this page