> ## Documentation Index > Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt > Use this file to discover all available pages before exploring further. # List episodes > Episode summaries for the authenticated owner, newest first. Cursor-paginated like the trace list. ## OpenAPI ````yaml https://prime-traces.pintel.dev/openapi.json get /api/v1/episodes openapi: 3.1.0 info: title: Prime Traces description: > Upload, query and delete training, evaluation and inference traces. Authenticate with a Prime Intellect API key that has the **Prime Traces** permission, sent as `Authorization: Bearer `. Send `X-Prime-Team-ID` to act on a team's traces instead of your personal ones. Errors share one envelope, `{"error": {"code", "message", "details?"}}`, where `code` is stable and safe to branch on. version: '0' servers: - url: https://prime-traces.pintel.dev security: [] paths: /api/v1/episodes: get: tags: - Episodes summary: List episodes description: >- Episode summaries for the authenticated owner, newest first. Cursor-paginated like the trace list. operationId: list_episodes_api_v1_episodes_get parameters: - name: run_id in: query required: false schema: anyOf: - type: array items: type: string - type: 'null' title: Run Id - name: environment_id in: query required: false schema: anyOf: - type: array items: type: string - type: 'null' title: Environment Id - name: outcome in: query required: false schema: anyOf: - type: array items: type: string - type: 'null' title: Outcome - name: run_step in: query required: false schema: anyOf: - type: array items: type: integer - type: 'null' title: Run Step - name: step_min in: query required: false schema: anyOf: - type: integer - type: 'null' title: Step Min - name: step_max in: query required: false schema: anyOf: - type: integer - type: 'null' title: Step Max - name: has_error in: query required: false schema: anyOf: - type: boolean - type: 'null' title: Has Error - name: created_after in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Created After - name: created_before in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Created Before - name: created_by in: query required: false schema: anyOf: - type: array items: type: string - type: 'null' title: Created By - name: limit in: query required: false schema: anyOf: - type: integer - type: 'null' title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor - name: x-prime-team-id in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Act on this team's traces instead of your personal ones. You must be a member of the team. title: X-Prime-Team-Id description: >- Act on this team's traces instead of your personal ones. You must be a member of the team. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EpisodePage' '400': description: >- An unknown query parameter or invalid filter value (`invalid_filter`), or a cursor issued for different filters (`invalid_cursor`). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: 'Missing or malformed `Authorization: Bearer ` header.' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- The API key lacks the required `traces` permission (`forbidden`), or Prime Traces is not enabled for this account (`service_not_enabled`). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '503': description: >- Storage or authentication is temporarily unavailable. Retry after the `Retry-After` header. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - PrimeApiKey: [] components: schemas: EpisodePage: properties: items: items: $ref: '#/components/schemas/EpisodeSummary' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor type: object required: - items - next_cursor title: EpisodePage ErrorResponse: properties: error: $ref: '#/components/schemas/ErrorBody' type: object required: - error title: ErrorResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError EpisodeSummary: properties: episode_id: type: string title: Episode Id upload_id: type: string title: Upload Id schema_version: type: integer title: Schema Version created_at: type: string format: date-time title: Created At ingested_at: type: string format: date-time title: Ingested At run_id: anyOf: - type: string - type: 'null' title: Run Id environment_id: anyOf: - type: string - type: 'null' title: Environment Id outcome: anyOf: - type: string - type: 'null' title: Outcome has_error: type: boolean title: Has Error error: $ref: '#/components/schemas/EpisodeError' type: object required: - episode_id - upload_id - schema_version - created_at - ingested_at - run_id - environment_id - outcome - has_error - error title: EpisodeSummary ErrorBody: properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string title: Message details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details type: object required: - code - message title: ErrorBody ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError EpisodeError: properties: type: anyOf: - type: string - type: 'null' title: Type message: anyOf: - type: string - type: 'null' title: Message type: object required: - type - message title: EpisodeError ErrorCode: type: string enum: - upload_too_large - trace_too_large - too_many_traces_in_episode - episode_id_too_long - environment_id_too_long - too_many_traces_in_upload - duplicate_trace_id - duplicate_episode_id - digest_mismatch - line_format_mismatch - malformed_encoding - invalid_trace - invalid_metadata - created_at_out_of_window - unsupported_schema_version - unknown_episode_reference - line_format_conflict - source_conflict - upload_attribution_conflict - billing_intent_required - invalid_idempotency_key - invalid_cursor - invalid_filter - search_limit_exceeded - unauthenticated - forbidden - service_not_enabled - auth_unavailable - trace_not_found - trace_not_indexed - run_not_found - episode_not_found - export_job_not_found - task_already_running - invalid_schedule_time - snapshot_not_due - statement_production_incomplete - statement_production_failed - rate_limited - writer_pool_saturated - ingest_capacity_exceeded - ingest_unavailable - storage_unavailable - index_task_queue_unavailable - internal_error title: ErrorCode securitySchemes: PrimeApiKey: type: http description: A Prime Intellect API key with the Prime Traces permission. scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.