# List interviews

Retrieve a list of all interviews. Supports filtering by project and external metadata.

External Metadata Filtering:
You can filter interviews using any external metadata field by using the pattern external_metadata[]=.
The ` can be any string, and the  can be any value that was stored as external metadata.

When multiple values are provided for the same external metadata field (e.g., external_metadata[field1]=abc&external_metadata[field1]=def), they are treated with OR logic, meaning the field should match any of the provided values.

Examples:
- GET /interviews?project_id=12345678-1234-1234-1234-123456789012 - Get all interviews for a specific project
- GET /interviews?external_metadata[someExternalId]=1234 - Filter by external ID
- GET /interviews?external_metadata[field1]=abc&external_metadata[field1]=def - Filter where field1 is either "abc" OR "def"
- GET /interviews?project_id=12345678-1234-1234-1234-123456789012&external_metadata[someExternalId]=1234&external_metadata[user_uuid]=abcd` - Filter by user ID, external ID, and project ID (AND logic applied between different fields)

Endpoint: GET /interviews
Version: 1.0.0
Security: api_key, tenant_id

## Query parameters:

  - `project_id` (string)
    Filter interviews by project ID
    Example: "12345678-1234-1234-1234-123456789012"

  - `external_metadata[<external_param>]` (string)
    Dynamic Parameter Pattern - This is not a literal parameter name but represents the pattern for filtering by external metadata.

Replace ` with any external metadata key you want to filter by. You can use multiple of these parameters in a single request.

Pattern: external_metadata[]=

Examples:
- external_metadata[someExternalId]=1234
- external_metadata[userId]=abc123 
- external_metadata[source]=web
- external_metadata[priority]=high`
    Example: "1234"

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.interview_id` (string, required)
    The unique identifier of the interview
    Example: "87654321-4321-4321-4321-210987654321"

  - `data.project_id` (string, required)
    The unique identifier of the project this interview belongs to
    Example: "12345678-1234-1234-1234-123456789012"

  - `data.created_at` (string, required)
    The timestamp when the interview was created (ISO 8601 format)
    Example: "2025-11-11T10:30:00Z"

## Response 400 fields (application/json):

  - `detail` (object)

  - `detail.error` (string)
    Example: "invalid_parameter"

  - `detail.message` (string)
    Example: "Invalid project_id format or external metadata parameter."

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)
    Example: "field required"

  - `detail.type` (string, required)
    Example: "value_error.missing"