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

# List Inbound cases

> Obtiene una lista paginada de casos de tipo inbound, con la posibilidad de filtrar por bot y rango de fechas.



## OpenAPI

````yaml GET /api/v2/inbound-case/
openapi: 3.0.0
info:
  title: API Inceptia
  description: API para la consulta de campañas, casos y llamadas de un bot.
  version: 2.0.0
servers:
  - url: https://admintest.inceptia.ai/
    description: Ambiente de pruebas
  - url: https://admin.inceptia.ai/
    description: Ambiente productivo
security: []
tags:
  - name: Autenticación
    description: Endpoints para la autenticación de usuarios y gestión de tokens.
  - name: Bots
    description: Endpoints para operaciones relacionadas con los bots.
  - name: Campañas
    description: Endpoints para operaciones relacionadas con las campañas.
  - name: Casos de campaña
    description: Endpoints para operaciones relacionadas con los casos de campaña.
  - name: Llamadas de campaña
    description: Endpoints para operaciones relacionadas con las llamadas de campaña.
  - name: Casos de inbound
    description: Endpoints para operaciones relacionadas con los casos de inbound.
paths:
  /api/v2/inbound-case/:
    get:
      tags:
        - Casos de inbound
      summary: Listar casos de Inbound
      description: >-
        Obtiene una lista paginada de casos de tipo inbound, con la posibilidad
        de filtrar por bot y rango de fechas.
      parameters:
        - name: bot
          in: query
          description: ID del bot para filtrar los casos.
          required: false
          schema:
            type: integer
        - name: local_updated__date__gte
          in: query
          description: Filtrar casos actualizados desde esta fecha (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: local_updated__date__lte
          in: query
          description: Filtrar casos actualizados hasta esta fecha (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
      responses:
        '200':
          description: Lista de casos de inbound obtenida correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedInboundCaseList'
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
      security:
        - jwtAuth: []
components:
  schemas:
    PaginatedInboundCaseList:
      type: object
      properties:
        count:
          type: integer
        next:
          type: string
          format: uri
          nullable: true
        previous:
          type: string
          format: uri
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/InboundCaseDetail'
    UnauthorizedError:
      type: object
      properties:
        token:
          type: string
      example:
        token: El token es inválido o ha expirado
    InboundCaseDetail:
      type: object
      properties:
        id:
          type: integer
        bot:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
            alias:
              type: string
            type:
              type: string
        case_uuid:
          type: string
          nullable: true
        phone:
          type: string
        first_name:
          type: string
        last_name:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        case_result:
          type: object
          properties:
            result_id:
              type: integer
            name:
              type: string
            is_final:
              type: boolean
            contacted:
              type: boolean
        case_duration:
          type: string
          format: duration
        case_log:
          type: object
          properties:
            responses:
              type: array
              items:
                type: object
            transcription:
              type: array
              items:
                type: object
        extra_metadata:
          type: object
        recording:
          type: string
          format: uri
        is_complete:
          type: boolean
        status:
          type: string
        last_updated:
          type: string
        is_active:
          type: boolean
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token de acceso JWT. Debe ser enviado como 'Bearer {token}'.

````