> ## Documentation Index > Fetch the complete documentation index at: https://docs.pomerado.ai/llms.txt > Use this file to discover all available pages before exploring further. # List the runs your team started > Lists the runs your team started, newest first, one numbered page at a time, with the totals of every page. A run is listed when a team member started it, in the Dashboard, through an agent or with an API key, on any tool: the team's own or a public one. * Every member sees every run the team started, whoever started it. * Filter by integration, status, source and time range, or find one run by its ID. * Runs stay listed for 90 days. * To follow a run you just started, use jobs.get with its job ID. Use this list to look back over the team's runs. * **Callers:** an MCP OAuth token or a Dashboard session. * **Permission:** `jobs:read`. * **Effect:** Changes nothing. * **Errors:** [`business_account_required`](/errors#business_account_required), and the [errors any request can get](/errors). ## OpenAPI ````yaml /api-reference/openapi.json get /v1/runs openapi: 3.1.0 info: title: Pomerado API version: '1' description: >- Run and build website tools, follow their jobs, and manage logins, API keys and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth token or a Dashboard session as a Bearer token. servers: - url: https://api.pomerado.ai security: [] tags: - name: account x-group: Account - name: api_keys x-group: API keys - name: connected_apps x-group: Connected apps - name: usage x-group: Usage - name: quota x-group: Quota - name: billing x-group: Billing - name: integrations x-group: Integrations - name: connect x-group: Connect - name: code x-group: Code - name: logins x-group: Saved logins - name: two_factor x-group: 2FA - name: login_access x-group: Login access - name: tools x-group: Tools - name: webhooks x-group: Webhooks - name: runs x-group: Runs - name: builds x-group: Builds - name: jobs x-group: Jobs - name: files x-group: Files - name: team x-group: Team paths: /v1/runs: get: tags: - runs summary: List the runs your team started description: >- Lists the runs your team started, newest first, one numbered page at a time, with the totals of every page. operationId: runs.list parameters: - name: integration_id in: query required: false description: 'an integration ID: int_ and 32 lowercase hex digits' schema: type: string examples: - int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 - name: status in: query required: false schema: type: string enum: - queued - running - needs_input - succeeded - failed - cancelled - name: source in: query required: false description: >- mcp: an agent over MCP signed in with OAuth. dashboard: a member in the Dashboard. api: an API key, an MCP connection that uses one, or OAuth on the API schema: type: string enum: - mcp - api - dashboard - name: from in: query required: false description: 'Accepted at or after, inclusive (default and earliest: 90 days ago)' schema: type: string - name: to in: query required: false description: 'Accepted before (default: now)' schema: type: string - name: run_id in: query required: false description: 'a job ID: job_ and 32 lowercase hex digits' schema: type: string examples: - job_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190 - name: page in: query required: false description: The page to read, from 1 (default 1) schema: type: string - name: limit in: query required: false description: Runs per page, 1 to 100 (default 20) schema: type: string responses: '200': description: One page of the team's runs content: application/json: schema: $ref: '#/components/schemas/RunList' '400': description: invalid_request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: unauthorized, reauthentication_required content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: business_account_required, forbidden content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: internal_error content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: temporarily_unavailable content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearer: [] components: schemas: RunList: type: object required: - data - page - limit - total - summary properties: data: type: array items: $ref: '#/components/schemas/Run' page: type: integer description: a non-negative number minimum: 0 limit: type: integer description: a non-negative number minimum: 0 total: type: integer description: Runs matching the filters, on every page minimum: 0 summary: type: object required: - succeeded - failed - cancelled - in_progress - median_duration_ms properties: succeeded: type: integer description: a non-negative number minimum: 0 failed: type: integer description: a non-negative number minimum: 0 cancelled: type: integer description: a non-negative number minimum: 0 in_progress: type: integer description: Queued, running or waiting for an answer minimum: 0 median_duration_ms: anyOf: - type: integer description: a non-negative number minimum: 0 - type: 'null' additionalProperties: false additionalProperties: false Error: type: object required: - error properties: error: type: object required: - code - message - retryable - docs_url properties: code: type: string message: type: string retryable: type: boolean docs_url: type: string details: type: object required: [] properties: {} additionalProperties: $id: /schemas/unknown additionalProperties: false additionalProperties: false Run: type: object required: - id - status - tool_id - tool_name - integration_id - integration_name - effect - write_status - source - started_by - login_id - revision - attempts - created_at - started_at - completed_at - duration_ms properties: id: type: string status: type: string enum: - queued - running - needs_input - succeeded - failed - cancelled tool_id: type: string tool_name: anyOf: - type: string - type: 'null' integration_id: anyOf: - type: string - type: 'null' integration_name: anyOf: - type: string - type: 'null' effect: anyOf: - type: string enum: - read - write - type: 'null' write_status: anyOf: - type: string enum: - not_attempted - may_have_applied - applied - not_applied - type: 'null' source: anyOf: - type: string enum: - mcp - api - dashboard - type: 'null' started_by: type: object required: - member_id - name - email - api_key properties: member_id: type: string description: The member's user ID name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' api_key: anyOf: - type: object required: - id - name properties: id: type: string name: type: string additionalProperties: false - type: 'null' additionalProperties: false login_id: anyOf: - type: string - type: 'null' revision: type: object required: - id - published_at properties: id: type: string published_at: anyOf: - type: string - type: 'null' additionalProperties: false attempts: type: integer description: a non-negative number minimum: 0 created_at: type: string started_at: anyOf: - type: string - type: 'null' completed_at: anyOf: - type: string - type: 'null' duration_ms: anyOf: - type: integer description: a non-negative number minimum: 0 - type: 'null' additionalProperties: false securitySchemes: bearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.