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

# Get application by ID

> Returns detailed information about a specific application



## OpenAPI

````yaml /api-reference/openapi.json get /application/{applicationid}
openapi: 3.0.3
info:
  title: JobAffinity REST API
  version: '1.13'
  description: >
    JobAffinity REST API for managing jobs, candidates, applications, and
    recruitment processes.


    ## Authentication

    All endpoints require HTTP Basic Authentication.


    ## Versioning

    Current version: 1.13


    See `/restapi/changelog` for version history and changes.
  contact:
    name: JobAffinity API Support
servers:
  - url: https://jobaffinity.fr/restapi/v1
    description: REST API v1
  - url: https://jobaffinity.fr/restapi
    description: REST API root (for changelog)
security:
  - basicAuth: []
tags:
  - name: API Info
    description: API metadata and changelog
  - name: Account
    description: Authenticated user identity and organisation membership
  - name: Jobs
    description: Job listings and details
  - name: Candidates
    description: Candidate information
  - name: Applications
    description: Job applications
  - name: Processes
    description: Recruitment processes and steps
  - name: Notes
    description: Candidate notes
  - name: Templates
    description: Recorded email templates
  - name: Questionnaires
    description: Questionnaire answers
  - name: Webhooks
    description: Webhook tasks
  - name: Job Application Submission
    description: >-
      Submit candidate applications to a job posting via the apply URL provided
      in the job feed. The authentication token is embedded in the URL — no
      additional credentials are required.
paths:
  /application/{applicationid}:
    get:
      tags:
        - Applications
      summary: Get application by ID
      description: Returns detailed information about a specific application
      operationId: getApplication
      parameters:
        - name: applicationid
          in: path
          required: true
          description: Application ID
          schema:
            type: integer
        - $ref: '#/components/parameters/organisationFilterParam'
      responses:
        '200':
          description: Application details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Application'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  parameters:
    organisationFilterParam:
      name: organisation_id
      in: query
      description: >-
        Narrow the read to a single organisation. Without it, the caller keeps
        its full visibility.
      schema:
        type: integer
  schemas:
    Application:
      type: object
      properties:
        _self:
          type: string
          format: uri
          description: URL of the application resource
        _schema:
          type: string
          format: uri
        _status:
          type: string
          enum:
            - OK
            - INVALID
        id:
          type: integer
          description: Application identifier
        date:
          type: string
          format: date-time
          description: Application submission date
        route:
          type: string
          description: Application route (how the candidate applied)
        questionnaire_score:
          type: number
          nullable: true
          description: >-
            Questionnaire score, or null when the candidate never answered the
            questionnaire (so a real score of 0 is unambiguous).
        score:
          type: number
          nullable: true
          description: >-
            Matching score of the application, or null when it was never
            evaluated.
        last_action_time:
          type: string
          format: date-time
          nullable: true
          description: Timestamp of the last action recorded on the application.
        candidate_last_action:
          type: string
          format: date-time
          nullable: true
          description: Timestamp of the last action recorded on the candidate.
        latest_cv_url:
          type: string
          format: uri
          nullable: true
          description: URL to download the latest CV (may redirect)
        candidate:
          type: object
          description: Inline candidate summary
          properties:
            id:
              type: integer
            _self:
              type: string
              format: uri
            applications:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
            title:
              type: string
              enum:
                - MR
                - MS
                - MRS
                - UNKNOWN
            first_name:
              type: string
            last_name:
              type: string
            email:
              type: string
              format: email
        source:
          type: object
          description: Source of the application
          properties:
            id:
              type: integer
            name:
              type: string
            posting_service:
              type: object
              properties:
                id:
                  type: integer
                  nullable: true
                name:
                  type: string
        job:
          type: object
          description: Inline job summary
          properties:
            _self:
              type: string
              format: uri
            id:
              type: integer
            title:
              type: string
            status:
              type: string
              enum:
                - OPEN
                - CLOSED
                - ARCHIVED
            applications:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
        step:
          type: object
          description: Current step of the application
          properties:
            id:
              type: integer
              nullable: true
            name:
              type: string
            status:
              type: string
              enum:
                - START
                - CURRENT
                - END
                - ''
            date:
              type: string
              format: date
              nullable: true
              description: Date when this step was set
        steps:
          type: object
          description: >-
            Full step history of the application (available in application
            detail, not in collection listings)
          properties:
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: integer
                  name:
                    type: string
                  status:
                    type: string
                    enum:
                      - START
                      - CURRENT
                      - END
                  date:
                    type: string
                    format: date
                  user:
                    $ref: '#/components/schemas/User'
            latest_cv_url:
              type: string
              format: uri
              nullable: true
        history:
          type: object
          description: >-
            Events recorded on the application, most recent first (available in
            application detail, not in collection listings). Capped at the 200
            latest.
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/ApplicationHistoryEvent'
        emails:
          type: object
          description: >-
            Archived incoming and outgoing emails of the application, most
            recent first (available in application detail, not in collection
            listings). Capped at the 100 latest.
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/ApplicationEmailSummary'
        notes:
          type: object
          properties:
            _self:
              type: string
              format: uri
    User:
      type: object
      properties:
        id:
          type: integer
          description: User identifier
        first_name:
          type: string
          description: First name of the user
        last_name:
          type: string
          description: Last name of the user
        email:
          type: string
          format: email
          description: Email of the user
    ApplicationHistoryEvent:
      type: object
      description: An event recorded on the application.
      properties:
        id:
          type: integer
          description: Event identifier
        date:
          type: string
          format: date-time
          description: When the event happened
        action:
          type: string
          description: Event type
        text:
          type: string
          description: Human-readable event description
        user:
          allOf:
            - $ref: '#/components/schemas/User'
          description: User who triggered the event, when known.
    ApplicationEmailSummary:
      type: object
      description: A summary of one archived email of the application.
      properties:
        id:
          type: integer
          description: Archived email identifier
        date:
          type: string
          format: date-time
        subject:
          type: string
        sender:
          type: string
        recipient:
          type: string
        received:
          type: boolean
          description: True when the email came from the candidate.
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      headers:
        WWW-Authenticate:
          schema:
            type: string
    NotFoundError:
      description: The specified resource was not found
      content:
        application/json:
          schema:
            type: object
            properties:
              _status:
                type: string
                enum:
                  - INVALID
              error:
                type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Authentication with API credentials

````

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