> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List jobs

> List the authenticated user's jobs from the last 7 days, newest first.

Older runs are not listed, but still answer `GET /jobs/{job_id}` by id.
Keyset-paginated: pass the returned `next_cursor` to get the next page;
it is `null` on the last page. Filters combine with AND.



## OpenAPI

````yaml GET /v1/jobs
openapi: 3.1.0
info:
  title: Mindcase API
  version: '1.0'
  description: Structured web data APIs for AI agents.
servers:
  - url: https://api.mindcase.co
security:
  - bearerAuth: []
paths:
  /v1/jobs:
    get:
      tags:
        - Developer API
      summary: List User Jobs
      description: |-
        List the authenticated user's jobs from the last 7 days, newest first.

        Older runs are not listed, but still answer `GET /jobs/{job_id}` by id.
        Keyset-paginated: pass the returned `next_cursor` to get the next page;
        it is `null` on the last page. Filters combine with AND.
      operationId: list_user_jobs_v1_jobs_get
      parameters:
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only return jobs in these states — one or a comma-separated list
              of `queued`, `running`, `completed`, `failed`, `cancelled`,
              `rejected_balance`. Omit for all.
            title: Status
          description: >-
            Only return jobs in these states — one or a comma-separated list of
            `queued`, `running`, `completed`, `failed`, `cancelled`,
            `rejected_balance`. Omit for all.
        - name: agent
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Only runs of this API, as `group/slug` (e.g. `zillow/properties`).
            title: Agent
          description: Only runs of this API, as `group/slug` (e.g. `zillow/properties`).
        - name: created_after
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only runs created at or after this ISO-8601 date/datetime (UTC if
              no offset).
            title: Created After
          description: >-
            Only runs created at or after this ISO-8601 date/datetime (UTC if no
            offset).
        - name: created_before
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only runs created before this ISO-8601 date/datetime (UTC if no
              offset).
            title: Created Before
          description: >-
            Only runs created before this ISO-8601 date/datetime (UTC if no
            offset).
        - name: run_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Find a run by its ID — the full UUID, or its first 6+ characters.
            title: Run Id
          description: Find a run by its ID — the full UUID, or its first 6+ characters.
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The `next_cursor` from the previous page. Omit for the newest
              runs.
            title: Cursor
          description: The `next_cursor` from the previous page. Omit for the newest runs.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            description: Jobs per page, newest first (max 100).
            default: 20
            title: Limit
          description: Jobs per page, newest first (max 100).
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Any error. See `error.code`.
          headers:
            X-Request-ID:
              description: >-
                The id of this call, also in `error.request_id`. Quote it when
                contacting support.
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying, on retryable errors.
              schema:
                type: integer
            RateLimit-Limit:
              description: Requests allowed per minute in this bucket.
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests left in the window.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until a slot frees.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKey: []
components:
  schemas:
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorBody'
        detail:
          title: Detail
          description: Legacy field, kept for existing clients. Prefer `error`.
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Errors
          description: >-
            Legacy per-field list on parameter errors. Same as
            `error.details.errors`.
      type: object
      required:
        - error
        - detail
      title: ErrorResponse
      description: >-
        The body of every non-2xx response.


        | Situation | How you see it | `retryable` | Wait |

        |---|---|---|---|

        | Rate limited | HTTP 429 | yes | `retry_after_seconds` |

        | We couldn't read your balance | HTTP 503, or a `failed` job with
        `balance_unavailable` | yes | 5s |

        | Something failed on our side | HTTP 5xx, or a `failed` job | yes | 30s
        |

        | Bad parameters | HTTP 422 | no | Fix them first |

        | Not enough balance | HTTP 402, or `rejected_balance` | no | Add
        balance first |

        | Bad API key | HTTP 401 | no | Fix the key first |

        | Run ended short with rows | `completed` with a `stop_reason` | no |
        Run again on purpose for the rest |


        Retry only when `retryable` is true, after `retry_after_seconds`.
        Without a

        wait, back off exponentially with jitter, up to 30s and about 5
        attempts.

        Send an `Idempotency-Key` so a retry can't charge twice.
    ErrorBody:
      properties:
        code:
          type: string
          title: Code
          description: Stable machine-readable code. Branch on this.
        message:
          type: string
          title: Message
          description: Plain English. May be reworded.
        request_id:
          type: string
          title: Request Id
          description: Quote this when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: Whether the same request, unchanged, can succeed later.
        retry_after_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retry After Seconds
          description: >-
            When `retryable` is true, how long to wait. Matches the
            `Retry-After` header.
        fault:
          type: string
          enum:
            - input
            - mindcase
          title: Fault
          description: >-
            Whose problem this is: `input` (the request; fix it first) or
            `mindcase` (ours).
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: Extra fields, per code.
      type: object
      required:
        - code
        - message
        - request_id
        - retryable
        - fault
      title: ErrorBody
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your Mindcase API key, mk_live_...
    ApiKey:
      type: http
      description: 'Your Mindcase API key: `Authorization: Bearer mk_live_...`'
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.