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

# Search open jobs

> Open jobs that match every given filter, newest first by default. Follow `next` for the next page.



## OpenAPI

````yaml /openapi.json get /v1/jobs
openapi: 3.1.0
info:
  title: LetsFindWork API
  version: '1'
servers:
  - url: https://api.letsfind.work
security:
  - bearer: []
paths:
  /v1/jobs:
    get:
      summary: Search open jobs
      description: >-
        Open jobs that match every given filter, newest first by default. Follow
        `next` for the next page.
      operationId: get_ListJobs
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title, company or department: any part of a
              word, any case. Every word must match.
          required: false
          description: >-
            Words to find in the title, company or department: any part of a
            word, any case. Every word must match.
          name: q
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title, company or department: any part of a
              word, any case. Every word must match.
          required: false
          description: >-
            Words to find in the title, company or department: any part of a
            word, any case. Every word must match.
          name: excludeQ
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title: any part of a word, any case. Every
              word must match.
          required: false
          description: >-
            Words to find in the title: any part of a word, any case. Every word
            must match.
          name: title
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the title: any part of a word, any case. Every
              word must match.
          required: false
          description: >-
            Words to find in the title: any part of a word, any case. Every word
            must match.
          name: excludeTitle
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the department: any part of a word, any case.
              Every word must match.
          required: false
          description: >-
            Words to find in the department: any part of a word, any case. Every
            word must match.
          name: department
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Words to find in the department: any part of a word, any case.
              Every word must match.
          required: false
          description: >-
            Words to find in the department: any part of a word, any case. Every
            word must match.
          name: excludeDepartment
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Whole words to find in the job text, any case, any language. Every
              word must match.
          required: false
          description: >-
            Whole words to find in the job text, any case, any language. Every
            word must match.
          name: text
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Whole words to find in the job text, any case, any language. Every
              word must match.
          required: false
          description: >-
            Whole words to find in the job text, any case, any language. Every
            word must match.
          name: excludeText
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Company name, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Company name, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: company
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Company name, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Company name, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: excludeCompany
          in: query
        - schema:
            type: boolean
            description: >-
              true: only jobs of staffing and recruiting firms; false: none of
              them. Firms are known by name (a list of large firms and the words
              such firms put in their names).
          required: false
          description: >-
            true: only jobs of staffing and recruiting firms; false: none of
            them. Firms are known by name (a list of large firms and the words
            such firms put in their names).
          name: agency
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Applicant tracking system, any case. Repeat the param to match any
              of several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Applicant tracking system, any case. Repeat the param to match any
            of several values; GET /v1/facets lists the values in use.
          name: ats
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Applicant tracking system, any case. Repeat the param to match any
              of several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Applicant tracking system, any case. Repeat the param to match any
            of several values; GET /v1/facets lists the values in use.
          name: excludeAts
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Workplace type, any case. Repeat the param to match any of several
              values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Workplace type, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: workplaceType
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Employment type, any case. Repeat the param to match any of
              several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            Employment type, any case. Repeat the param to match any of several
            values; GET /v1/facets lists the values in use.
          name: employmentType
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Language of the job text (ISO 639-1), any case. Repeat the param
              to match any of several values; GET /v1/facets lists the values in
              use.
          required: false
          description: >-
            Language of the job text (ISO 639-1), any case. Repeat the param to
            match any of several values; GET /v1/facets lists the values in use.
          name: language
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 20
            description: >-
              A place in any common form: a city ("Munich", "München, DE"), a
              region in any language or its ISO 3166-2 code ("Bavaria",
              "Bayern", "DE-BY"), a country or its code ("Germany", "DE"), a
              group of countries ("Europe", "EU"). "Remote" or "Remote in
              Germany" keep remote jobs only. Repeat the param to match any of
              several places.
          required: false
          description: >-
            A place in any common form: a city ("Munich", "München, DE"), a
            region in any language or its ISO 3166-2 code ("Bavaria", "Bayern",
            "DE-BY"), a country or its code ("Germany", "DE"), a group of
            countries ("Europe", "EU"). "Remote" or "Remote in Germany" keep
            remote jobs only. Repeat the param to match any of several places.
          name: location
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 20
            description: >-
              A place in any common form: a city ("Munich", "München, DE"), a
              region in any language or its ISO 3166-2 code ("Bavaria",
              "Bayern", "DE-BY"), a country or its code ("Germany", "DE"), a
              group of countries ("Europe", "EU"). "Remote" or "Remote in
              Germany" keep remote jobs only. Repeat the param to match any of
              several places.
          required: false
          description: >-
            A place in any common form: a city ("Munich", "München, DE"), a
            region in any language or its ISO 3166-2 code ("Bavaria", "Bayern",
            "DE-BY"), a country or its code ("Germany", "DE"), a group of
            countries ("Europe", "EU"). "Remote" or "Remote in Germany" keep
            remote jobs only. Repeat the param to match any of several places.
          name: excludeLocation
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Country (ISO 3166-1 alpha-2, any case); a job in several places
              matches any. Repeat the param to match any of several values; GET
              /v1/facets lists the values in use.
          required: false
          description: >-
            Country (ISO 3166-1 alpha-2, any case); a job in several places
            matches any. Repeat the param to match any of several values; GET
            /v1/facets lists the values in use.
          name: country
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Region or state, as GET /v1/facets lists it, or its ISO 3166-2
              code ("DE-BY"). Repeat the param to match any of several values;
              GET /v1/facets lists the values in use.
          required: false
          description: >-
            Region or state, as GET /v1/facets lists it, or its ISO 3166-2 code
            ("DE-BY"). Repeat the param to match any of several values; GET
            /v1/facets lists the values in use.
          name: region
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              City, as GET /v1/facets lists it. Repeat the param to match any of
              several values; GET /v1/facets lists the values in use.
          required: false
          description: >-
            City, as GET /v1/facets lists it. Repeat the param to match any of
            several values; GET /v1/facets lists the values in use.
          name: city
          in: query
        - schema:
            type: array
            items:
              type: string
              pattern: ^\d{1,4}$
            minItems: 1
            maxItems: 50
            description: >-
              ISCO-08 occupation code or group prefix ("25" holds "2512").
              Repeat to match any.
          required: false
          description: >-
            ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat
            to match any.
          name: occupation
          in: query
        - schema:
            type: array
            items:
              type: string
              pattern: ^\d{1,4}$
            minItems: 1
            maxItems: 50
            description: >-
              ISCO-08 occupation code or group prefix ("25" holds "2512").
              Repeat to match any.
          required: false
          description: >-
            ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat
            to match any.
          name: excludeOccupation
          in: query
        - schema:
            type:
              - integer
              - 'null'
            minimum: 0
            maximum: 10000000
            description: >-
              Yearly pay at least this, in EUR (the middle of the employer's
              range, converted at the day's rate). Jobs without pay are left
              out.
          required: false
          description: >-
            Yearly pay at least this, in EUR (the middle of the employer's
            range, converted at the day's rate). Jobs without pay are left out.
          name: salaryMinEur
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 200
            minItems: 1
            maxItems: 50
            description: >-
              Industry of the company, as Wikidata names it ("software
              industry"); jobs of companies with no known industry are left out.
              Repeat the param to match any of several values; GET /v1/facets
              lists the values in use.
          required: false
          description: >-
            Industry of the company, as Wikidata names it ("software industry");
            jobs of companies with no known industry are left out. Repeat the
            param to match any of several values; GET /v1/facets lists the
            values in use.
          name: industry
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - 1-10
                - 11-50
                - 51-200
                - 201-500
                - 501-1000
                - 1001-5000
                - 5001-10000
                - 10001+
            minItems: 1
            maxItems: 8
            description: >-
              Headcount band of the company. Repeat to match any; jobs of
              companies with no known headcount are left out.
          required: false
          description: >-
            Headcount band of the company. Repeat to match any; jobs of
            companies with no known headcount are left out.
          name: companySize
          in: query
        - schema:
            type: boolean
            description: >-
              true: one job per duplicate group (the first posted) and every job
              without duplicates; false: only the other jobs of each group.
              Without it, all jobs. A group is the same company, title and
              places on two or more boards, posted within 30 days.
          required: false
          description: >-
            true: one job per duplicate group (the first posted) and every job
            without duplicates; false: only the other jobs of each group.
            Without it, all jobs. A group is the same company, title and places
            on two or more boards, posted within 30 days.
          name: canonical
          in: query
        - schema:
            anyOf:
              - type: string
                format: date-time
              - type: string
                format: date
            description: >-
              Jobs posted (or first seen, when earlier or undated) at or after
              this date or time, UTC
          required: false
          description: >-
            Jobs posted (or first seen, when earlier or undated) at or after
            this date or time, UTC
          name: postedAfter
          in: query
        - schema:
            type: array
            items:
              type: integer
              exclusiveMinimum: 0
              maximum: 2147483647
            minItems: 1
            maxItems: 100
            description: Job ids. Repeat the param to match any, up to 100.
          required: false
          description: Job ids. Repeat the param to match any, up to 100.
          name: ids
          in: query
        - schema:
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 2000
            minItems: 1
            maxItems: 10
            description: >-
              The job's URL on its board or its application form URL, exactly as
              the job has it. Repeat the param to match any, up to 10.
          required: false
          description: >-
            The job's URL on its board or its application form URL, exactly as
            the job has it. Repeat the param to match any, up to 10.
          name: url
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - health
                - retirement
                - paid_time_off
                - wellness
            minItems: 1
            maxItems: 4
            description: >-
              Benefit the job text offers, read by rules: health, retirement,
              paid_time_off, wellness. Repeat the param to match any.
          required: false
          description: >-
            Benefit the job text offers, read by rules: health, retirement,
            paid_time_off, wellness. Repeat the param to match any.
          name: benefit
          in: query
        - schema:
            type: boolean
            description: >-
              Read by rules from the job text. true: jobs that say they sponsor
              visas; false: jobs that say they do not, or that need the right to
              work already. Jobs whose text says nothing are left out.
          required: false
          description: >-
            Read by rules from the job text. true: jobs that say they sponsor
            visas; false: jobs that say they do not, or that need the right to
            work already. Jobs whose text says nothing are left out.
          name: visaSponsorship
          in: query
        - schema:
            type: string
            enum:
              - newest
              - oldest
            default: newest
            description: By posted date (or first seen, when earlier or undated)
          required: false
          description: By posted date (or first seen, when earlier or undated)
          name: sort
          in: query
        - schema:
            type: string
            maxLength: 200
            description: '`next` from the previous page'
          required: false
          description: '`next` from the previous page'
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
            description: Results per page
          required: false
          description: Results per page
          name: limit
          in: query
        - 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: A page of jobs
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobs:
                    type: array
                    items:
                      $ref: '#/components/schemas/JobWithText'
                  next:
                    type:
                      - string
                      - 'null'
                required:
                  - jobs
                  - next
        '403':
          description: fullText=true from an account not allowed to read full text
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.