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

# API reference

> Every endpoint, param and field, from the OpenAPI spec.

The API describes itself in an OpenAPI 3.1 spec. The endpoint pages in this section are built from it, so they always match the code.

* **Live spec:** `GET $BASE_URL/openapi.json`. It needs no key.
* **Base URL:** `https://api.letsfind.work`. Every path starts with `/v1`.
* **Auth:** `Authorization: Bearer <key>` on every `/v1` request. See [Authentication](https://docs.letsfind.work/authentication.md).
* **Format:** JSON in UTF-8. Dates are ISO 8601 in UTC. Field names are camelCase.

Use the spec to generate a client in your language, or import it into Postman or Insomnia.

## Endpoints

| Endpoint | What it returns |
| - | - |
| `GET /v1/jobs` | Open jobs that match your filters, one page at a time |
| `GET /v1/jobs/{id}` | One open job |
| `GET /v1/facets` | Open jobs per filter value |
| `GET /v1/companies` | Companies with open jobs |

## Fields that can be empty

* `postedAt` is `null` when the employer's board gives no date. `firstSeenAt` is always set.
* `countries`, `regions` and `cities` are empty lists when we could not read the place.
* `salary` is `""` and the other pay fields are `null` when the employer publishes no pay.
* `occupation` is `null` when we could not tell the occupation.
* `language` is `""` when we could not tell the language.


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