# New 911 Call

{% hint style="warning" %}
This API endpoint requires the **standard** version of Sonoran CAD or higher. For more information, see our [pricing ](/cad/pricing/faq.md)page.
{% endhint %}

## Emergency Call

<mark style="color:green;">`POST`</mark> `https://api.sonorancad.com/emergency/call_911`

The 911 call API endpoint allows you to send 911 calls from in-game directly to your dispatchers.

#### Request Body

| Name | Type   | Description                     |
| ---- | ------ | ------------------------------- |
| id   | string | Your community's ID             |
| key  | string | Your community's API Key        |
| type | string | CALL\_911                       |
| data | array  | Array of emergency call objects |

{% tabs %}
{% tab title="200 A successful call will be met with the following response:" %}

```
EMERGENCY CALL ADDED ID: {ID}
```

{% endtab %}

{% tab title="400 The following 400 errors may be sent in response" %}

```
INVALID REQUEST TYPE
INVALID COMMUNITY ID
API IS NOT ENABLED FOR THIS COMMUNITY
INVALID API KEY
```

{% endtab %}
{% endtabs %}

```javascript
{
    "id": "YOUR_COMMUNITY_ID",
    "key": "YOUR_API_KEY",
    "type": "CALL_911",
    "data": [
        {
            "serverId": 1, // Server ID Integer
            "isEmergency": true, // Displays EMERGENCY or CIVIL type in the CAD
            "caller": "John Doe",
            "location": "1234 E. Test St.",
            "description": "Help, someone is breaking into my house!",
            "metaData": {
                "someKey": "someValue", // OPTIONAL: metaData for API custom storage
                "x": 1000, // OPTIONAL: Live Map X Coordinate
                "y": 1000 // OPTIONAL: Live Map Y Coordinate
            },
            "deleteAfterMinutes": 30 // OPTIONAL: Delete record after X minutes (temporary record)
        }
    ]
}
```

### Server ID

Because Sonoran CAD allows you to separate units and dispatchers into separate servers, the serverId field ensures this emergency call is sent to the appropriate dispatcher.\
\
For more information, see our guide on [configuring multiple servers](/cad/tutorials/customization/configuring-multiple-servers.md).

### Meta Data

The `metaData` object can be used to store custom API data in the 911 call.

Additionally, the following `metaData` properties will auto-set the dispatch call information:

| Property   | Type    | Description                                        |
| ---------- | ------- | -------------------------------------------------- |
| `priority` | Integer | <p>Dispatch call priority</p><p>Values 1, 2, 3</p> |
| `block`    | String  | Dispatch Call Block                                |
| `postal`   | String  | Dispatch Call Postal                               |
| `code`     | String  | Dispatch Call 10-Code                              |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonoransoftware.com/cad/api-integration/api-endpoints/emergency/dispatch-and-emergency-calls/911-call.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.