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

# Get Call Status

## Overview

The "Get Call Status" endpoint allows users to retrieve the current status of a specific call in Toingg. By sending a GET request to the `/call_status` endpoint, users can obtain detailed information about the call's progress, including its current state, duration, and any errors encountered. This endpoint is essential for monitoring call performance and ensuring that campaigns are running smoothly.

#### Example cURL Request

```bash theme={null}
curl -X 'GET' \
  'https://api.toingg.com/api/v3/call_status?callId=yourCallId' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer yourBearerToken'
```

* `callId`: A unique identifier for the call whose status is being queried. This parameter is required to fetch the specific call's details.

### Response

The response will include the following fields:

* `status`: Indicates the current status of the call (e.g., "in-progress", "completed", "failed").
* `duration`: The total time the call has been active, measured in seconds.
* `startTime`: The timestamp when the call started.
* `endTime`: The timestamp when the call ended, if applicable.
* `error`: Provides details of any errors encountered during the call, if any.

These details help users track the progress and outcome of their calls, allowing for real-time monitoring and troubleshooting.


## OpenAPI

````yaml GET /call_status
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.toingg.com/api/v3
security: []
paths:
  /call_status:
    get:
      tags:
        - Call handling
      summary: Call Status
      operationId: call_status_call_status_get
      parameters:
        - name: callId
          in: query
          required: true
          schema:
            type: string
            title: Callid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: login

````