> ## 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 job by ID

> Returns detailed information about a specific job



## OpenAPI

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


    ## Authentication

    All endpoints require HTTP Basic Authentication.


    ## Versioning

    Current version: 1.12


    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: 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: 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:
  /job/{jobid}:
    get:
      tags:
        - Jobs
      summary: Get job by ID
      description: Returns detailed information about a specific job
      operationId: getJob
      parameters:
        - name: jobid
          in: path
          required: true
          description: Job ID
          schema:
            type: integer
      responses:
        '200':
          description: Job details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  schemas:
    Job:
      allOf:
        - $ref: '#/components/schemas/JobLite'
        - type: object
          properties:
            _schema:
              type: string
              format: uri
            _status:
              type: string
              enum:
                - OK
                - INVALID
            reference:
              type: string
              description: Job reference code
            client:
              type: string
              description: Job client
            location:
              type: object
              description: Job location with postal address and geographic coordinates
              properties:
                address:
                  type: string
                  description: Street address
                postalcode:
                  type: string
                  description: Postal code
                town:
                  type: string
                  description: Town
                country:
                  type: string
                  description: Country (ISO 3166-1 alpha-2)
                longitude:
                  type: number
                  description: Geographic longitude
                latitude:
                  type: number
                  description: Geographic latitude
            description:
              type: string
              description: Job description (HTML format)
            employer_description:
              type: string
              description: Employer description
            position_description:
              type: string
              description: Position description
            profile_description:
              type: string
              description: Required profile description
            creation_date:
              type: string
              format: date
              description: Job creation date (YYYY-MM-DD)
            owner:
              allOf:
                - $ref: '#/components/schemas/User'
              description: User responsible for the job
            contract_type:
              $ref: '#/components/schemas/ContractType'
            term:
              $ref: '#/components/schemas/JobTerm'
            organisation:
              $ref: '#/components/schemas/Organisation'
            attributes:
              type: object
              description: Custom job attributes
              properties:
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                        description: Display name of the attribute
                      api_name:
                        type: string
                        description: API name of the attribute
                      value:
                        type: string
                        description: Value of the attribute
            questionnaire:
              type: object
              nullable: true
              description: Questionnaire associated with the job, or null if none
            process:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
                id:
                  type: integer
                  description: Process identifier
            team:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
    JobLite:
      type: object
      properties:
        _self:
          type: string
          format: uri
          description: URL of the job resource
        id:
          type: integer
          description: Job identifier
        title:
          type: string
          description: Job title
        status:
          type: string
          description: Job status
          enum:
            - DRAFT
            - PENDING_APPROVAL
            - PUBLISHED
            - CLOSED
            - ARCHIVED
        applications:
          type: object
          properties:
            _self:
              type: string
              format: uri
              description: URL to list applications for this job
    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
    ContractType:
      type: object
      properties:
        name:
          type: string
          description: Long name of the contract type
        abbreviation:
          type: string
          description: Short name of the contract type
    JobTerm:
      type: object
      properties:
        count:
          type: integer
          description: Term count of the job
        unit:
          type: string
          description: Term unit of the job
          enum:
            - DAY
            - MONTH
            - YEAR
    Organisation:
      type: object
      properties:
        id:
          type: integer
          description: Organisation identifier
        name:
          type: string
          description: Name of the organisation
  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

````