> ## 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.

# Get an application

> COMING SOON: This operation is a contract preview and is not currently available.

Get one application with its current state, failure information,
discovered fields, accepted answers, correction errors, and terminal
delivery attempts. Use this endpoint to reconcile after callback or
network outages.




## OpenAPI

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

    real-time feeds, geocoding services, and a contract preview for
    callback-driven

    job applications. Auto Apply is coming soon and is not available in beta or
    production.
  version: '2026-07-21'
  contact:
    name: Jobo Support
    url: https://jobo.world
    email: support@jobo.world
  license:
    name: Proprietary — see terms of service
    url: https://jobo.world/terms
  termsOfService: https://jobo.world/terms
servers:
  - url: https://connect.jobo.world
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Jobs
    description: Search and retrieve job listings
  - name: Feed
    description: Bulk job feeds and expiration tracking
  - name: Companies
    description: Company profiles and company-scoped job listings
  - name: Auto Apply
    description: >-
      Coming soon: profileless applications answered through signed, typed HTTPS
      callbacks
  - name: Locations
    description: Geocoding and location services
paths:
  /api/auto-apply/applications/{id}:
    get:
      tags:
        - Auto Apply
      summary: Get an application
      description: >
        COMING SOON: This operation is a contract preview and is not currently
        available.


        Get one application with its current state, failure information,

        discovered fields, accepted answers, correction errors, and terminal

        delivery attempts. Use this endpoint to reconcile after callback or

        network outages.
      operationId: getAutoApplyApplication
      parameters:
        - name: id
          in: path
          required: true
          description: Application ID.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Detailed application state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoApplyApplication'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Application not found or owned by another account.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '503':
          description: Auto Apply management endpoints are temporarily unavailable.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-codeSamples:
        - lang: cURL
          source: >
            curl
            "https://connect.jobo.world/api/auto-apply/applications/6f9227f6-b704-4b58-a553-79773a041933"
            \
              -H "X-Api-Key: $JOBO_API_KEY"
components:
  schemas:
    AutoApplyApplication:
      allOf:
        - $ref: '#/components/schemas/AutoApplyApplicationSummary'
        - type: object
          required:
            - callback_url
            - callback_source
            - provider_version
            - matcher_revision
            - catalog_revision
            - settings_revision
            - failure
            - canceled_by
            - steps
            - events
          properties:
            callback_url:
              type: string
              format: uri
              description: >-
                Effective callback URL captured when the application was
                created.
            callback_source:
              type: string
              enum:
                - account_default
                - application_override
              description: Where the effective callback URL came from.
            provider_version:
              type: string
              description: Provider implementation version captured at intake.
            matcher_revision:
              type: integer
              format: int64
            catalog_revision:
              type: integer
              format: int64
            settings_revision:
              type: integer
              format: int64
            failure:
              type: object
              allOf:
                - $ref: '#/components/schemas/AutoApplyFailure'
              nullable: true
            canceled_by:
              type: string
              nullable: true
              description: Actor that completed cancellation, when applicable.
            steps:
              type: array
              items:
                $ref: '#/components/schemas/AutoApplyApplicationStep'
            events:
              type: array
              description: Terminal webhook deliveries and their attempts.
              items:
                $ref: '#/components/schemas/AutoApplyEventDelivery'
    ProblemDetails:
      type: object
      description: 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
        code:
          type: string
          nullable: true
          description: Stable machine-readable code for Auto Apply domain errors.
        api_version:
          $ref: '#/components/schemas/AutoApplyApiVersion'
    AutoApplyApplicationSummary:
      type: object
      required:
        - api_version
        - id
        - job_id
        - apply_url
        - provider_id
        - provider_name
        - status
        - cancel_requested
        - status_updated_at
        - queued_at
        - started_at
        - submitted_at
        - failed_at
        - canceled_at
        - completed_at
        - created_at
      properties:
        api_version:
          $ref: '#/components/schemas/AutoApplyApiVersion'
        id:
          type: string
          format: uuid
          description: Stable application ID.
        job_id:
          type: string
          nullable: true
          description: Supplied Jobo job ID, or null when apply_url was supplied directly.
        apply_url:
          type: string
          format: uri
          description: Resolved application URL.
        provider_id:
          type: string
          description: Stable provider identifier selected at intake.
        provider_name:
          type: string
          description: Provider display name captured at intake.
        status:
          $ref: '#/components/schemas/AutoApplyApplicationStatus'
        cancel_requested:
          type: boolean
          description: Whether cancellation has been requested.
        status_updated_at:
          type: string
          format: date-time
        queued_at:
          type: string
          format: date-time
        started_at:
          type: string
          format: date-time
          nullable: true
        submitted_at:
          type: string
          format: date-time
          nullable: true
        failed_at:
          type: string
          format: date-time
          nullable: true
        canceled_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
          description: submitted_at, failed_at, or canceled_at, whichever is set.
        created_at:
          type: string
          format: date-time
    AutoApplyFailure:
      type: object
      required:
        - code
        - message
        - retryable
      properties:
        code:
          type: string
          description: Stable machine-readable failure code.
          example: submission_unconfirmed
        message:
          type: string
          description: Safe human-readable failure detail.
        retryable:
          type: boolean
          description: Whether retrying can be considered safe.
    AutoApplyApplicationStep:
      type: object
      required:
        - id
        - sequence
        - status
        - correction_round
        - fields
        - answers
        - command_errors
        - created_at
        - completed_at
        - field_count
        - answer_count
      properties:
        id:
          type: string
          format: uuid
        sequence:
          type: integer
          minimum: 1
        status:
          type: string
          description: Durable processing state for this form step.
          example: answered
        correction_round:
          type: integer
          minimum: 0
        fields:
          type: array
          items:
            $ref: '#/components/schemas/AutoApplyField'
        answers:
          type: array
          description: Accepted answers for this step. Never reused by another application.
          items:
            $ref: '#/components/schemas/AutoApplyAnswer'
        command_errors:
          type: array
          description: Validation errors returned in the next correction callback.
          items:
            $ref: '#/components/schemas/AutoApplyCommandError'
        created_at:
          type: string
          format: date-time
        completed_at:
          type: string
          format: date-time
          nullable: true
        field_count:
          type: integer
          minimum: 0
        answer_count:
          type: integer
          minimum: 0
    AutoApplyEventDelivery:
      type: object
      required:
        - id
        - type
        - status
        - attempt_count
        - attempts
        - created_at
        - delivered_at
      properties:
        id:
          type: string
          description: Terminal webhook event ID.
        type:
          type: string
          enum:
            - application.submitted
            - application.failed
            - application.canceled
        status:
          type: string
          enum:
            - pending
            - delivering
            - delivered
            - exhausted
        attempt_count:
          type: integer
          minimum: 0
        attempts:
          type: array
          items:
            $ref: '#/components/schemas/AutoApplyEventDeliveryAttempt'
        created_at:
          type: string
          format: date-time
        delivered_at:
          type: string
          format: date-time
          nullable: true
    AutoApplyApiVersion:
      type: string
      description: Version of the profileless Auto Apply API contract.
      enum:
        - '2026-07-21'
      example: '2026-07-21'
    AutoApplyApplicationStatus:
      type: string
      description: Current durable application state.
      enum:
        - queued
        - running
        - awaiting_answers
        - submitted
        - failed
        - canceled
    AutoApplyField:
      type: object
      required:
        - field_id
        - type
        - group_type
        - label
        - required
        - requires_answer
        - current_value
        - options
        - constraints
        - category
        - semantic_key
        - sensitive
        - format
        - min_items
        - max_items
        - item_fields
      properties:
        field_id:
          type: string
          description: Stable within this callback event; echo it in the answer.
        type:
          $ref: '#/components/schemas/AutoApplyFieldType'
        group_type:
          type: string
          allOf:
            - $ref: '#/components/schemas/AutoApplyGroupType'
          nullable: true
          description: Set only when type is repeating_group.
        label:
          type: string
        required:
          type: boolean
          description: Whether the ATS marks the field required.
        requires_answer:
          type: boolean
          description: Whether the callback must supply this field exactly once.
        current_value:
          description: Current ATS value, or null when empty.
        options:
          type: array
          description: Allowed values for select, radio, multi_select, and related fields.
          items:
            $ref: '#/components/schemas/AutoApplyFieldOption'
        constraints:
          type: object
          additionalProperties: {}
          description: Type-specific limits such as minimum_precision.
        category:
          type: string
          nullable: true
        semantic_key:
          type: string
          nullable: true
          description: Stable semantic hint such as address.country.
        sensitive:
          type: boolean
          description: True for voluntary self-identification and similar sensitive fields.
        format:
          type: string
          nullable: true
        min_items:
          type: integer
          minimum: 0
          nullable: true
          description: Minimum complete items for a repeating group.
        max_items:
          type: integer
          minimum: 0
          maximum: 10
          nullable: true
          description: Provider limit, capped at ten by the platform.
        item_fields:
          type: array
          description: Ordered child-field contract for each repeating-group item.
          items:
            $ref: '#/components/schemas/AutoApplyGroupItemField'
    AutoApplyAnswer:
      type: object
      required:
        - field_id
        - value
      properties:
        field_id:
          type: string
          description: Exact field_id from the fields_requested event.
        value:
          $ref: '#/components/schemas/AutoApplyAnswerValue'
    AutoApplyCommandError:
      type: object
      required:
        - field_id
        - item_index
        - field_key
        - code
        - message
      properties:
        field_id:
          type: string
          nullable: true
        item_index:
          type: integer
          minimum: 0
          nullable: true
          description: Zero-based index for a repeating-group error.
        field_key:
          type: string
          nullable: true
          description: Child key for a repeating-group error.
        code:
          type: string
          description: Stable validation error code.
          example: invalid_option
        message:
          type: string
    AutoApplyEventDeliveryAttempt:
      type: object
      required:
        - attempt
        - at
        - response_status
        - error
      properties:
        attempt:
          type: integer
          minimum: 1
        at:
          type: string
          format: date-time
        response_status:
          type: integer
          minimum: 100
          maximum: 599
          nullable: true
        error:
          type: string
          nullable: true
          description: Null after successful delivery; otherwise a stable result code.
    AutoApplyFieldType:
      type: string
      description: |
        Expected JSON value is determined by this type. repeating_group values
        are ordered arrays whose items follow item_fields.
      enum:
        - text
        - textarea
        - select
        - multi_select
        - radio
        - checkbox
        - number
        - date
        - partial_date
        - typeahead
        - file
        - repeating_group
        - unknown
    AutoApplyGroupType:
      type: string
      description: Semantic kind of a repeating group.
      enum:
        - education
        - work_experience
        - website
        - language
        - skill
        - other
    AutoApplyFieldOption:
      type: object
      required:
        - value
        - label
      properties:
        value:
          type: string
          description: Exact value the answer must use.
        label:
          type: string
          description: Display text shown by the ATS.
    AutoApplyGroupItemField:
      type: object
      required:
        - key
        - type
        - label
        - required
        - options
        - constraints
      properties:
        key:
          type: string
          description: Exact object key to use in each group item.
        type:
          $ref: '#/components/schemas/AutoApplyFieldType'
        label:
          type: string
        required:
          type: boolean
        options:
          type: array
          items:
            $ref: '#/components/schemas/AutoApplyFieldOption'
        constraints:
          type: object
          additionalProperties: {}
    AutoApplyAnswerValue:
      description: |
        Value selected by the corresponding field type. Repeating education and
        work_experience fields use the typed ordered arrays shown here; other
        groups use the same advertised-item contract.
      anyOf:
        - $ref: '#/components/schemas/AutoApplyScalarAnswerValue'
        - $ref: '#/components/schemas/AutoApplyEducationGroupValue'
        - $ref: '#/components/schemas/AutoApplyWorkExperienceGroupValue'
        - $ref: '#/components/schemas/AutoApplyGenericRepeatingGroupValue'
    AutoApplyScalarAnswerValue:
      description: |
        Typed scalar value. text, textarea, select, and radio use strings;
        checkbox uses a boolean; number uses a JSON number; multi_select uses an
        array of option-value strings; date and partial_date use date strings;
        typeahead and file use their structured objects.
      anyOf:
        - type: string
        - type: number
        - type: boolean
        - type: array
          items:
            type: string
        - $ref: '#/components/schemas/AutoApplyTypeaheadValue'
        - $ref: '#/components/schemas/AutoApplyFileValue'
    AutoApplyEducationGroupValue:
      type: array
      maxItems: 10
      description: |
        Ordered education entries. The callback must follow the event's
        item_fields exactly; these common properties illustrate the typed shape.
      items:
        allOf:
          - $ref: '#/components/schemas/AutoApplyRepeatingGroupItem'
          - type: object
            properties:
              school:
                anyOf:
                  - type: string
                  - $ref: '#/components/schemas/AutoApplyTypeaheadValue'
              degree:
                type: string
              field_of_study:
                type: string
              start_date:
                type: string
                pattern: ^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$
              end_date:
                type: string
                nullable: true
                pattern: ^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$
              graduation_date:
                type: string
                nullable: true
                pattern: ^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$
              description:
                type: string
      example:
        - school:
            query: MIT
            selection:
              value: school_123
              label: Massachusetts Institute of Technology
          degree: BS
          field_of_study: Computer Science
          start_date: 2017-09
          graduation_date: 2021-06
    AutoApplyWorkExperienceGroupValue:
      type: array
      maxItems: 10
      description: |
        Ordered work-history entries. The callback must follow the event's
        item_fields exactly; these common properties illustrate the typed shape.
      items:
        allOf:
          - $ref: '#/components/schemas/AutoApplyRepeatingGroupItem'
          - type: object
            properties:
              company:
                anyOf:
                  - type: string
                  - $ref: '#/components/schemas/AutoApplyTypeaheadValue'
              title:
                type: string
              location:
                type: string
              start_date:
                type: string
                pattern: ^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$
              end_date:
                type: string
                nullable: true
                pattern: ^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$
              is_current:
                type: boolean
              description:
                type: string
      example:
        - company: Acme
          title: Engineer
          location: Remote
          start_date: 2021-03
          end_date: null
          is_current: true
          description: Built internal systems.
    AutoApplyGenericRepeatingGroupValue:
      type: array
      maxItems: 10
      description: Ordered website, language, skill, or other group entries.
      items:
        $ref: '#/components/schemas/AutoApplyRepeatingGroupItem'
    AutoApplyTypeaheadValue:
      type: object
      required:
        - query
        - selection
      properties:
        query:
          type: string
          description: Text used to search the ATS typeahead.
        selection:
          type: object
          required:
            - value
            - label
          properties:
            value:
              type: string
              description: Exact result value returned by the ATS.
            label:
              type: string
              description: Result display label.
      example:
        query: MIT
        selection:
          value: school_123
          label: Massachusetts Institute of Technology
    AutoApplyFileValue:
      type: object
      required:
        - url
        - filename
      properties:
        url:
          type: string
          format: uri
          description: >-
            Signed public HTTPS URL Jobo can download within the callback
            deadline.
        filename:
          type: string
          minLength: 1
        content_type:
          type: string
          nullable: true
          example: application/pdf
      example:
        url: https://files.example.com/signed/resume.pdf
        filename: resume.pdf
        content_type: application/pdf
    AutoApplyRepeatingGroupItem:
      type: object
      description: |
        One complete repeating-group item. Keys not advertised in item_fields
        are rejected; each value must match the advertised child type.
      additionalProperties:
        $ref: '#/components/schemas/AutoApplyGroupItemValue'
    AutoApplyGroupItemValue:
      description: |
        Typed value for one advertised item field. Null is used only when the
        advertised item contract permits it.
      anyOf:
        - $ref: '#/components/schemas/AutoApplyScalarAnswerValue'
        - type: string
          nullable: true
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key provided by Jobo

````