openapi: 3.1.0
info:
  title: JustCall REST Calls API
  description: REST API for the JustCall cloud phone and contact center platform. Covers placing and listing calls, sending SMS, managing contacts, users, phone numbers, and related resources. Authentication uses an API key and API secret obtained from the JustCall dashboard.
  version: '2.1'
  contact:
    name: JustCall Developer Portal
    url: https://developer.justcall.io/docs/overview
servers:
- url: https://api.justcall.io/v2.1
  description: JustCall production API (v2.1)
security:
- ApiKeyAuth: []
tags:
- name: Calls
  description: Manage and query voice calls handled through JustCall.
paths:
  /calls:
    get:
      summary: List calls
      description: Retrieves all calls linked to an account, with optional filters to refine the call selection (such as date range, agent, contact, or direction).
      operationId: listCalls
      tags:
      - Calls
      responses:
        '200':
          description: A list of calls.
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: JustCall authentication. Pass the API key and API secret as defined in the JustCall Authentication documentation (typically combined and passed in the Authorization header).