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

# Companies with open jobs



## OpenAPI

````yaml /openapi.json get /v1/companies
openapi: 3.1.0
info:
  title: LetsFindWork API
  version: '1'
servers:
  - url: https://api.letsfind.work
security:
  - bearer: []
paths:
  /v1/companies:
    get:
      summary: Companies with open jobs
      operationId: get_ListCompanies
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: Part of the company name, any case
          required: false
          description: Part of the company name, any case
          name: q
          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: >-
              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: 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
      responses:
        '200':
          description: A page of companies
          content:
            application/json:
              schema:
                type: object
                properties:
                  companies:
                    type: array
                    items:
                      $ref: '#/components/schemas/Company'
                  next:
                    type:
                      - string
                      - 'null'
                required:
                  - companies
                  - next
components:
  schemas:
    Company:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
          description: Use it in the company filter of GET /v1/jobs
        ats:
          type: string
        boardUrl:
          type: string
          format: uri
          description: The company's job board
        openJobs:
          type: integer
        domain:
          type:
            - string
            - 'null'
          description: >-
            The company's website domain, as its own board pages name it; null
            when unsure
        industries:
          type: array
          items:
            type: string
          description: Industries, from Wikidata; empty when unknown
        employees:
          type:
            - integer
            - 'null'
          description: Headcount, from Wikidata; null when unknown
        size:
          type:
            - string
            - 'null'
          description: Headcount band (the companySize filter); null when unknown
        hqCountry:
          type:
            - string
            - 'null'
          description: >-
            ISO 3166-1 alpha-2 code of the headquarters, from Wikidata; null
            when unknown
        wikidata:
          type:
            - string
            - 'null'
          description: >-
            The Wikidata item the facts come from ("Q95"); null when none
            matched with confidence
      required:
        - id
        - name
        - ats
        - boardUrl
        - openJobs
        - domain
        - industries
        - employees
        - size
        - hqCountry
        - wikidata
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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