> ## 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 company and its hiring signals

> Free: it returns no job.



## OpenAPI

````yaml /openapi.json get /v1/companies/{id}
openapi: 3.1.0
info:
  title: LetsFindWork API
  version: '1'
servers:
  - url: https://api.letsfind.work
security:
  - bearer: []
paths:
  /v1/companies/{id}:
    get:
      summary: One company and its hiring signals
      description: 'Free: it returns no job.'
      operationId: get_GetCompany
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 2147483647
            description: The company id from GET /v1/companies
          required: true
          description: The company id from GET /v1/companies
          name: id
          in: path
      responses:
        '200':
          description: The company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyDetail'
        '404':
          description: No company with this id
components:
  schemas:
    CompanyDetail:
      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
        history:
          type: array
          items:
            type: object
            properties:
              day:
                type: string
                format: date
              openJobs:
                type: integer
            required:
              - day
              - openJobs
          description: >-
            Open jobs at the end of each day they changed, up to 180 days back;
            a day without an entry had the count of the entry before
        added30d:
          type: integer
          description: Jobs first seen in the last 30 days
        closed30d:
          type: integer
          description: Jobs the employer took down in the last 30 days
        avgDaysOpen:
          type:
            - number
            - 'null'
          description: >-
            Hiring speed: the average days a job stayed open, over jobs closed
            in the last 90 days; null under 3 of them
        newCountries:
          type: array
          items:
            type: string
          description: >-
            Countries of jobs first seen in the last 30 days that none of its
            older jobs had
        newCities:
          type: array
          items:
            type: string
          description: Cities, the same way
      required:
        - id
        - name
        - ats
        - boardUrl
        - openJobs
        - domain
        - industries
        - employees
        - size
        - hqCountry
        - wikidata
        - history
        - added30d
        - closed30d
        - avgDaysOpen
        - newCountries
        - newCities
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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