> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revenueable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Making Your First Call

> This tutorial will guide you through the process of making your first outbound call using Revenueable AI's Voice API

## Prerequisites

Before you begin, make sure you have:

* An active Revenueable AI account

* Your API key (X-API-KEY)

* An assistant configured for outbound calls

* A phone number assigned to your workspace

## Execution

***Step 1: Choose an Assistant***

First, retrieve a list of your assistants to find the appropriate assistant ID:

```javascript theme={null}
const options = {method: 'GET', headers: {'X-API-KEY': 'your-api-key-here'}};

fetch('https://prod-api.revenueable.ai/ca/api/v0/agent/all', options)
  .then(response => response.json())
  .then(response => {
     // Find an assistant with agent_type: "outbound"
    const outboundAssistants = response.data.agents.filter(agent => agent.agent_type === "outbound");
    console.log(outboundAssistants);
  })
  .catch(err => console.error(err));
```

***Step 2: Get Available Phone Numbers***

Next, retrieve the list of phone numbers in your workspace:

```javascript theme={null}
const options = {method: 'GET', headers: {'X-API-KEY': 'your-api-key-here'}};

fetch('https://prod-api.revenueable.ai/ca/api/v0/workspace/numbers', options)
  .then(response => response.json())
  .then(response => {
     // Select a phone number to use as caller ID
    console.log(response.workspace_numbers);
  })
  .catch(err => console.error(err));
```

***Step 3: Initiate the Call***

Now, make the call using the assistant ID and phone number ID you obtained:

```javascript theme={null}
const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': 'your-api-key-here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "John Doe",
    "mobile_number": "+1234567890",
    "agent_id": "830f767a-397e-4b39-82ff-235cd344e2f9",  // Replace with your assistant ID
    "from_number_id": "3735b71d-e770-4409-8707-14c795f49970",  // Replace with your phone number ID
    "custom_args_values": {
       // Include any custom variables required by your assistant
      "callee_name": "John",
      "mobile_number": "+1234567890"
    }
  })
};

fetch('https://prod-api.revenueable.ai/ca/api/v0/calling/outbound/individual', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```

***Step 4: Check Call Status***

After initiating the call, you'll receive a response with the call details:

```json theme={null}
{
  "Call Status": "success",
  "data": {
    "Unique Call ID": "dd6c63db-66c7-42ae-9a82-e4988bef428e",
    "Call Direction": "outbound",
    "Call Status": "registered",
    "From Number": "+918035737034",
    "To Number": "+919994008915",
    "Initiated at": "2025-04-24T04:22:47.722294",
    "Agent ID": "cdcf1b39-173a-4492-8396-c493123ea443",
    "System generated message": "Call initiated successfully"
  }
}
```

The `Call Status` field shows the current status of your call. Here are the possible statuses:

* **`registered`** - Call has been queued and is waiting to be processed
* **`ongoing`** - Call is currently in progress
* **`retry`** - System has to retry at the next\_attempt\_time
* **`completed`** - User has picked the call and discussion happened
* **`failed`** - All the retries have been exhausted
* **`error`** - One of the terminal state. Any unknown error
* **`cancelled`** - Call was cancelled

***Step 5: Retrieve Call History***

You can check the call history to see the status and details of your call:

```javascript theme={null}
const options = {method: 'GET', headers: {'X-API-KEY': 'your-api-key-here'}};

fetch('https://prod-api.revenueable.ai/ca/api/v0/calling/history', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```