> ## 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.


            Keys in `main_agent_variables` starting with `X-` are additionally
            sent as custom SIP headers (SIP runs) or connection headers
            (WebSocket runs) to the agent under test. For SIP runs this is the
            only way to pass custom headers; `X-Run-Id`, `X-Scenario-Id`, and
            `X-Result-Id` are reserved and always set by Cekura.
        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.

````