# Incoming Calls

## HTTP Post from CallAPI to your web server

Once you have the Incoming Call URL set, the web calls will come in normal HTTP post variables as displayed below.\
**POST Objects - Incoming Post Request - New Incoming Call**<br>

```php
POST fields in readable format:
    [CallSid]       => IDfbf7e812ere32hfhfg6e10-Cd5dacca0c-CA9d3572be-9f7a-11ea-97f4-5ffeb3239325
    [InstanceId]    => ID242258723hHds8fh29G4569b66e10
    [AccountSid]    => AC06bc1hjh293hFH9edjJ23539a9ddb1
    [From]          => 3035550000
    [To]            => 8044731212
    [CallStatus]    => ringing OR completed OR failed OR in-progress OR no-answer
    [ApiVersion]    => 2012-04-24
    [Direction]     => inbound
    [CallerName]    => 3035550000
    [ForwardedFrom] => null
    [CallTimestamp] => 2020-05-26T17:59:16.555Z
    [PostStatus]    => callback OR new
```

**POST Objects - Status Update from an Outbound Call**

```php
    [CallSid]           => ID242253601re32hfhfg6e10-CAceda56a709534034ae7c0e3a304b4d96
    [InstanceId]        => ID242258723hHds8fh29G4569b66e10
    [AccountSid]        => AC06bc1hjh293hFH9edjJ23539a9ddb1
    [From]              => 8044735555
    [To]                => 3035551212
    [CallStatus]        => in-progress
    [ApiVersion]        => 2012-04-24
    [Direction]         => outbound-api
    [CallerName]        => 8044735896
    [ForwardedFrom]     => null
    [CallTimestamp]     => 2020-05-26T17:29:55.125Z
    [VoicemailDetector] => voicemail [or] person_found
```

#### 3.4.1 Post Fields - Incoming Calls <a href="#calls_attributes" id="calls_attributes"></a>

| Attribute         | Description                                                                                                                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CallSid**       | A string that uniquely identifies this call.                                                                                                                                                                    |
| **InstanceId**    | Server instance ID that this call came from.                                                                                                                                                                    |
| **AccountSid**    | The date that this call was created.                                                                                                                                                                            |
| **From**          | The party who initiated the call.                                                                                                                                                                               |
| **To**            | The party who received the call.                                                                                                                                                                                |
| **CallStatus**    | <p>A descriptive status for the call. The value is one of these:</p><p>completed, failed, ringing, in-progress, no-answer, queued, wait-for-answer, or initiated</p>                                            |
| **ApiVersion**    | Always set to 2012-04-24.                                                                                                                                                                                       |
| **Direction**     | Always inbound for inbound calls.                                                                                                                                                                               |
| **CallerName**    | <p>If this call was an incoming call, the caller’s name.<br>Empty otherwise.</p>                                                                                                                                |
| **ForwardedFrom** | Where the call was forwarded from (null normally).                                                                                                                                                              |
| **CallTimestamp** | Timestamp when the call began: 2023-06-01T03:15:51.929Z.                                                                                                                                                        |
| **PostStatus**    | <p>Set to new or callback <br><em><strong>new</strong></em> - the call is coming in for the first time. <br><em><strong>callback</strong></em> - this is a callback notification / advancement of the call.</p> |

## Incoming Call Actions

Once a call has been posted to your server, you can use the API Call Markup Language to process requests. A quick example:

```
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="woman">Please hold while your call is connceted</Say>
    <Dial>18004444444</Dial>
</Response>
```

[Click here to view the Markup Language documentation.](/call-api-markup/api-call-markup-language.md)


---

# 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://apidocs.api19.com/call-apis/incoming-calls.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.