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

# List Test Profiles

> List test profiles



## OpenAPI

````yaml get /test_framework/v1/test-profiles/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /test_framework/v1/test-profiles/:
    get:
      tags:
        - test_framework
      description: List test profiles
      operationId: test-profiles-list
      parameters:
        - in: query
          name: agent_id
          schema:
            type: integer
          description: ID of the agent. Either agent_id or project_id must be provided.
        - in: query
          name: project_id
          schema:
            type: integer
          description: ID of the project. Either agent_id or project_id must be provided.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AIAgentTestProfileList'
              examples:
                ListTestProfiles:
                  value:
                    - agent: 123
                      name: <string>
                      information:
                        main_agent_variables:
                          user_id: <string>
                          account_id: <string>
                        testing_agent_variables:
                          user_name: <string>
                          user_email: <string>
                  summary: List Test Profiles
          description: ''
      security:
        - api_key: []
components:
  schemas:
    AIAgentTestProfileList:
      type: object
      description: |-
        List variant that also embeds the scenarios attached to each profile.

        Only used by `TestProfileViewSet.list` — retrieve/create/update and any
        nested usage (e.g. `ScenarioSerializer.test_profile_data`) should keep
        using `AIAgentTestProfileSerializer`.
      properties:
        id:
          type: integer
          readOnly: true
        project:
          type:
            - integer
            - 'null'
        agent:
          type:
            - integer
            - 'null'
        agent_name:
          type: string
          readOnly: true
          description: |

            Name of the agent associated with this test profile
            Example: `"Customer Support Agent"`
        name:
          type: string
          maxLength: 255
        information:
          description: >

            Variables for the test profile, split by which agent receives them.

            ```json

            {
                "main_agent_variables": {"user_id": "U-123"},
                "testing_agent_variables": {"user_name": "John Doe", "user_email": "john.doe@example.com"}
            }

            ```

            `main_agent_variables` are sent to the agent under test as dynamic
            variables. `testing_agent_variables` shape the simulated caller's
            persona. A legacy flat dict (no section keys) is accepted for
            backward compatibility and is sent to both agents.
        created_by:
          type: integer
          readOnly: true
          description: ID of the user who created this test profile
        last_updated_by:
          type: integer
          readOnly: true
          description: ID of the user who last updated this test profile
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: Timestamp when the test profile was created
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: Timestamp when the test profile was last updated
        scenarios:
          type: string
          readOnly: true
          description: List of scenarios using this test profile
      required:
        - name
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````