---
title: "Stop call"
slug: "stop-call"
updated: 2024-10-25T14:31:16Z
published: 2024-10-25T14:31:16Z
canonical: "docs.voiso.com/stop-call"
---

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

# Stop call

The **Stopcall** API is part of Voiso's Voice APIs. Use it to end calls for agents from external systems. The API endpoint description is [here](/v1-api/apidocs/stopcall).

## Prerequisites

- The agent should be a user in your contact center and have an [extension](https://docs.voiso.com/docs/users-users#adding-a-user) configured.
- The agent must be [logged in](https://docs.voiso.com/docs/agent-panel-getting-started#login).
- The agent must be handling a call.

## Making requests

The **Stopcall** API requires the [base URL](/v1-api/apidocs/base-endpoint) (cluster_id) and the [contact center API key](/v1-api/apidocs/authentication) (client_api_key). It uses the following parameters to terminate a call:

The `agent` parameter is the agent's extension. This tells Voiso whose call to end. The call is stopped automatically on the agent's configured phone in **Agent Panel**, the **Omnichannel Workspace**, or a third-party SIP client (softphone or hard phone).

For example:

```
{
  "method": "POST",
  "url": "https://cluster1.voiso.com/api/v1/cc7c7b8981d...0ab6c3/click2call_hangup",
  "params": {
    "agent": "1002"
  }
}
```

## Response

There is no response body for this API.

## Troubleshooting

The following issues are sometimes encountered:

### No active calls

If you see this error, `"error": "No active calls"`, there is no active call on the extension you specified.

### Rate limit exceeded

If you see this error, `"error": "Rate limit exceeded"`, the number of permitted requests to the server is exceeded, and requests are being throttled.

### Invalid agent's extension

If you see this error, `"error": "Invalid agent's extension"`, the extension specified is either in the wrong format or is not assigned to any agent. Ensure the agent's [extension](https://docs.voiso.com/docs/users-users#adding-a-user) is correctly formatted.

### Invalid API key

The **Stopcall** API uses the contact center API key to validate the request. If you see this error, `"error": "Invalid API key"`, check that you are using the correct contact center API key. For more information about API keys, refer to [Authentication](/v1-api/apidocs/authentication).