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

# List applications

> List applications for the calling account, newest first. Filter by profile with `profile_id`.



## OpenAPI

````yaml /openapi.yaml get /api/auto-apply/applications
openapi: 3.1.0
info:
  title: Jobo Enterprise API
  description: >
    The Jobo Enterprise API provides programmatic access to job listings,
    intelligent search,

    real-time feeds, automated job applications, and geocoding services.
  version: 1.0.0
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs Search
    description: Search and retrieve job listings
  - name: Jobs Feed
    description: Bulk job feeds and expiration tracking
  - name: Career Sites Feed
    description: Bulk feed of newly discovered career sites with enriched company profiles
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply Profiles
    description: Resume-first applicant profiles that power automated applications
  - name: Auto Apply Applications
    description: >-
      Fully automated job applications — submit asynchronously and poll for the
      outcome
  - name: Auto Apply Sessions
    description: Interactive, step-by-step application sessions with full answer control
  - name: Locations
    description: Geocoding and location services
paths:
  /api/auto-apply/applications:
    get:
      tags:
        - Auto Apply Applications
      summary: List applications
      description: >-
        List applications for the calling account, newest first. Filter by
        profile with `profile_id`.
      operationId: listAutoApplyApplications
      parameters:
        - name: profile_id
          in: query
          schema:
            type: string
            format: uuid
          description: Only return applications submitted with this profile.
        - name: page
          in: query
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number (1-indexed).
        - name: page_size
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
          description: Results per page.
      responses:
        '200':
          description: Paged list of applications
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationList'
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ApplicationList:
      type: object
      description: Paged list of applications, newest first.
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Application'
          description: Applications on this page.
        total_count:
          type: integer
          description: Total applications matching the filter.
          example: 42
        page:
          type: integer
          description: Current page number (1-indexed).
          example: 1
        page_size:
          type: integer
          description: Results per page.
          example: 20
        total_pages:
          type: integer
          description: Total number of pages.
          example: 3
    ValidationProblemDetails:
      allOf:
        - $ref: '#/components/schemas/ProblemDetails'
        - type: object
          properties:
            errors:
              type: object
              additionalProperties:
                type: array
                items:
                  type: string
              description: Map of field name to list of validation error messages.
    Application:
      type: object
      description: >-
        One automated application run. Created with `status = running`; poll
        `GET /api/auto-apply/applications/{id}` until it becomes `submitted` or
        `failed`.
      properties:
        id:
          type: string
          format: uuid
          description: Application identifier.
          example: f3b9c2d1-7e8a-4b5c-9d0e-1f2a3b4c5d6e
        profile_id:
          type: string
          format: uuid
          description: The profile the application was submitted with.
          example: 8c5e6d0a-9f2b-4c1e-b7a3-2f4d5e6a7b8c
        job_url:
          type: string
          description: The job posting's application URL.
          example: https://boards.greenhouse.io/acme/jobs/4567890
        session_id:
          type: string
          format: uuid
          description: The underlying browser session driving this run.
          example: 6f1d2b3c-4a5e-4f60-9b7a-8c9d0e1f2a3b
        provider_id:
          type: string
          description: Detected ATS provider identifier. Empty until detection completes.
          example: greenhouse
        provider_name:
          type: string
          description: Human-readable ATS provider name.
          example: Greenhouse
        status:
          $ref: '#/components/schemas/ApplicationStatus'
        failure_reason:
          type: string
          nullable: true
          enum:
            - login_required
            - captcha_required
            - expired
            - redirected
            - redirect_required
            - unsupported_provider
            - max_steps_reached
            - stalled
            - no_fields_found
            - no_answers_generated
            - error
            - null
          description: >-
            Machine-readable terminal reason, set only when `status` is
            `failed`. `login_required`, `captcha_required`, `redirected`,
            `redirect_required`, and `unsupported_provider` are reserved — those
            situations report `error` until dedicated detection ships; treat the
            enum as open.
          example: null
        error:
          type: string
          nullable: true
          description: Human-readable failure detail, set only when `status` is `failed`.
          example: null
        steps_completed:
          type: integer
          description: Number of form pages/steps the run got through.
          example: 3
        fields_filled:
          type: integer
          description: Total number of form fields filled across all steps.
          example: 24
        duration_ms:
          type: integer
          format: int64
          description: Wall-clock duration of the run in milliseconds.
          example: 93000
        step_log:
          type: array
          items:
            $ref: '#/components/schemas/AutoApplyStepLog'
          description: Per-step audit log of everything the run did.
        created_at:
          type: string
          format: date-time
          description: UTC timestamp the application was created.
          example: '2026-07-05T10:15:00Z'
        completed_at:
          type: string
          format: date-time
          nullable: true
          description: UTC timestamp the run finished, or null while `status` is `running`.
          example: null
    ProblemDetails:
      type: object
      description: RFC 7807 problem details object returned for error responses.
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
    ApplicationStatus:
      type: string
      description: >-
        Lifecycle of an asynchronous application run. `running` — being filled
        and submitted, keep polling; `submitted` — successfully submitted;
        `failed` — ended without submitting, see `failure_reason` and `error`.
      enum:
        - running
        - submitted
        - failed
      example: running
    AutoApplyStepLog:
      type: object
      description: One entry in an application run's audit log.
      properties:
        step:
          type: integer
          description: 1-indexed step number.
          example: 1
        action:
          type: string
          description: >-
            What the step did (e.g. `navigate`, `fill_fields`, `next`,
            `submit`).
          example: fill_fields
        status:
          type: string
          description: Step outcome (e.g. `ok`, `error`).
          example: ok
        fields_count:
          type: integer
          description: Number of fields filled during this step.
          example: 12
        error:
          type: string
          nullable: true
          description: Error detail when the step failed.
          example: null
        timestamp:
          type: string
          format: date-time
          description: UTC timestamp of the step.
          example: '2026-07-05T10:15:42Z'
        fields:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AutoApplyStepFieldLog'
          description: >-
            Per-field detail for field steps: every field a scan found or set
            attempt made, in full. Omitted for other actions and for runs
            recorded before this shipped.
    AutoApplyStepFieldLog:
      type: object
      description: >-
        One field in a scan or set step. Scan rows describe the field found
        (label, type, required, current value); set rows describe the attempt
        outcome (status, value set, note/error), with label/type joined from the
        session's preceding scan when available.
      properties:
        field_id:
          type: string
          description: Stable field identifier, unique within the page.
          example: f0:cards[123]_field0
        label:
          type: string
          nullable: true
          description: Human-readable question or label text, truncated to 120 characters.
          example: Full name
        type:
          type: string
          nullable: true
          description: Field type (e.g. `text`, `select`, `radio`, `checkbox`, `file`).
          example: text
        required:
          type: boolean
          nullable: true
          description: Present and `true` when the field is required.
          example: true
        value:
          type: string
          nullable: true
          description: >-
            Current value at scan time (scan rows) or the value set (set rows),
            truncated to 200 characters.
          example: John W. Smith
        status:
          type: string
          nullable: true
          description: >-
            Set-attempt outcome (e.g. `filled`, `typed`, `no_match`); null on
            scan rows.
          example: filled
        options:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AutoApplyStepFieldOptionLog'
          description: >-
            Available choices for select/radio/checkbox fields. On set rows,
            joined from the session's preceding scan when available.
        note:
          type: string
          nullable: true
          description: >-
            Explanatory note from the agent (e.g. the visible options when
            nothing matched).
          example: null
        error:
          type: string
          nullable: true
          description: Field-level error detail.
          example: null
    AutoApplyStepFieldOptionLog:
      type: object
      description: One selectable choice on a select/radio/checkbox field.
      properties:
        value:
          type: string
          description: The option's underlying value.
          example: us
        text:
          type: string
          nullable: true
          description: The option's display text, truncated to 120 characters.
          example: United States
  responses:
    Unauthorized:
      description: Missing or invalid API key
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````