> ## Documentation Index > Fetch the complete documentation index at: https://outcrawl.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Query past agent runs and browser sessions by status, outcome, task or age, each with its replay URL, duration, charg... > Query past agent runs and browser sessions by status, outcome, task or age, each with its replay URL, duration, charges and who may watch it. Use to find the session behind a charge or a failure; not for what happened inside one, which is outcrawl_session_network. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/sessions openapi: 3.1.0 info: title: Outcrawl API version: 1.0.0 summary: >- Web infrastructure for AI agents: scrape, crawl, search, agents and browsers on one credit balance. description: >- Outcrawl exposes one API surface at `https://api.outcrawl.ai/v1`, generated here from the 60-row capability registry that is the only truth about what it serves. Every request carries one bearer credential: an API key, or an OAuth access token from `outcrawl login` or an MCP client that signed in. There is exactly one base URL for every capability below. This document is GENERATED by `scripts/generate-openapi.mjs` from `outcrawl-browser@6631b29`. It is never hand-edited; `node scripts/generate-openapi.mjs --check` fails the build on drift. contact: name: Outcrawl url: https://outcrawl.ai/contact servers: - url: https://api.outcrawl.ai description: The only API surface. security: - ApiKeyAuth: [] tags: - name: Agent - name: Crawl - name: Credits - name: Integrations - name: Monitors - name: Profiles - name: Purchases - name: Rules - name: Scrape - name: Search - name: Secrets - name: Sessions - name: Usage - name: Wallet paths: /v1/sessions: get: tags: - Sessions summary: >- Query past agent runs and browser sessions by status, outcome, task or age, each with its replay URL, duration, charg... description: >- Query past agent runs and browser sessions by status, outcome, task or age, each with its replay URL, duration, charges and who may watch it. Use to find the session behind a charge or a failure; not for what happened inside one, which is outcrawl_session_network. operationId: sessionsList responses: '200': description: >- Query past agent runs and browser sessions by status, outcome, task or age, each with its replay URL, duration, charges and who may watch it. Use to find the session behind a charge or a failure; not for what happened inside one, which is outcrawl_session_network. content: application/json: schema: type: object description: >- See the matching capability page under docs/app/ and the SDK reference for the exact shape. '400': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '408': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: >- The request failed. `code` is one of the 22 values in the Error schema below. content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] components: schemas: Error: type: object required: - code - message properties: code: type: string description: >- Machine-readable, one of the 45 values in the closed union. Branch on this, never on `message`. enum: - unauthorized - profile_in_use - cap_exceeded - exit_unavailable - no_capacity - tenant_scope - bad_request - not_found - profile_not_found - method_not_allowed - capability_unavailable - decode_unavailable - quota_exceeded - concurrency_limit - plan_required - page_unreachable - document_unrepresentable - page_lost - extraction_failed - answer_lost - deadline_exceeded - lab_arm_forbidden - search_refused - integration_check_failed - integration_changed - secret_intent_invalid - secret_intent_spent - cvc_not_storable - run_secrets_limit - run_secret_undeliverable - replay_access_denied - replay_control_denied - replay_control_cross_site - spend_cap_required - card_number_in_task - merchant_not_allowed - spend_cap_exceeded - per_purchase_exceeded - no_open_purchase - approval_denied - approval_timed_out - secret_in_answer - provider_test_failed - provider_cards_open - internal message: type: string description: Human-readable, fixed per code. Never parsed. details: type: object additionalProperties: true description: Optional structured context, shape depends on `code`. securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- An Outcrawl API key, `ock_.`, minted in the console at https://outcrawl.ai/console/keys, or an OAuth access token, `oat_...`, issued by https://outcrawl.ai/api/auth with scope `api` (the CLI gets one from `outcrawl login`, an MCP client when it signs in). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.