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

# One open job



## OpenAPI

````yaml /openapi.json get /v1/jobs/{id}
openapi: 3.1.0
info:
  title: LetsFindWork API
  version: '1'
servers:
  - url: https://api.letsfind.work
security:
  - bearer: []
paths:
  /v1/jobs/{id}:
    get:
      summary: One open job
      operationId: get_GetJob
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 2147483647
            description: The job id from a search
          required: true
          description: The job id from a search
          name: id
          in: path
        - schema:
            type: boolean
            default: false
            description: >-
              true: each job also has `description`, its full text. Only for
              accounts allowed to read it (403 otherwise).
          required: false
          description: >-
            true: each job also has `description`, its full text. Only for
            accounts allowed to read it (403 otherwise).
          name: fullText
          in: query
      responses:
        '200':
          description: The job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobWithText'
        '403':
          description: fullText=true from an account not allowed to read full text
        '404':
          description: No open job with this id (closed jobs leave every result)
components:
  schemas:
    JobWithText:
      allOf:
        - $ref: '#/components/schemas/Job'
        - type: object
          properties:
            description:
              type: string
              description: >-
                The full job text as the employer wrote it (plain text). Only
                with fullText=true, for accounts allowed to read it.
    Job:
      type: object
      properties:
        id:
          type: integer
        title:
          type: string
        company:
          type: string
        department:
          type:
            - string
            - 'null'
        location:
          type: string
          description: The location as the employer wrote it
        workplaceType:
          type: string
          description: remote, hybrid or onsite
        employmentType:
          type:
            - string
            - 'null'
        language:
          type: string
          description: ISO 639-1 code of the job text; empty when unknown
        countries:
          type: array
          items:
            type: string
          description: ISO 3166-1 alpha-2 codes of the job's places; empty when unknown
        regions:
          type: array
          items:
            type: string
          description: >-
            English names ("Bavaria"), or as the employer wrote them when
            unknown
        regionCodes:
          type: array
          items:
            type: string
          description: ISO 3166-2 codes of the regions ("DE-BY")
        cities:
          type: array
          items:
            type: string
        timezones:
          type: array
          items:
            type: string
          description: IANA time zones of the job's places
        latitudes:
          type: array
          items:
            type: number
          description: One point per known city, same order as longitudes
        longitudes:
          type: array
          items:
            type: number
        agency:
          type: boolean
          description: Posted by a staffing or recruiting firm
        duplicateGroupId:
          type:
            - integer
            - 'null'
          description: >-
            Jobs with the same value are one opening on several boards; null
            when the job has no duplicate
        canonical:
          type: boolean
          description: >-
            The job to keep of its duplicate group (the first posted); true for
            a job without duplicates
        salary:
          type: string
          description: The pay as the employer wrote it; empty when not given
        salaryMin:
          type:
            - number
            - 'null'
        salaryMax:
          type:
            - number
            - 'null'
        salaryCurrency:
          type:
            - string
            - 'null'
          description: ISO 4217
        salaryPeriod:
          type:
            - string
            - 'null'
          description: hour, day, week, month or year
        salaryYearEur:
          type:
            - integer
            - 'null'
          description: Middle of the range per year in EUR, for comparing across currencies
        occupation:
          type:
            - string
            - 'null'
          description: >-
            ISCO-08 code: 4 digits, or 1 to 3 when only the group is known; null
            when unknown
        postedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: The employer's own date; null when its board gives none
        firstSeenAt:
          type: string
          format: date-time
        snippet:
          type: string
          description: One or two sentences of the job text, without contact data
        benefits:
          type: array
          items:
            type: string
            enum:
              - health
              - retirement
              - paid_time_off
              - wellness
          description: >-
            Benefits the job text offers, read by rules: health (health,
            medical, dental or vision insurance), retirement (pension, 401(k)),
            paid_time_off, wellness (gym, fitness, wellbeing or mental health
            programs). Empty when it names none of these
        visaSponsorship:
          type:
            - boolean
            - 'null'
          description: >-
            Read by rules from the job text. true: it says it sponsors visas;
            false: it says it does not, or that candidates must already have the
            right to work; null: it says nothing
        ats:
          type: string
          description: The applicant tracking system the job is posted on
        url:
          type: string
          format: uri
          description: The job on the employer's board
        applyUrl:
          type: string
          format: uri
          description: The employer's application form
      required:
        - id
        - title
        - company
        - department
        - location
        - workplaceType
        - employmentType
        - language
        - countries
        - regions
        - regionCodes
        - cities
        - timezones
        - latitudes
        - longitudes
        - agency
        - duplicateGroupId
        - canonical
        - salary
        - salaryMin
        - salaryMax
        - salaryCurrency
        - salaryPeriod
        - salaryYearEur
        - occupation
        - postedAt
        - firstSeenAt
        - snippet
        - benefits
        - visaSponsorship
        - ats
        - url
        - applyUrl
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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