---
title: "One employer."
method: GET
path: "/v1/companies/{slug}"
tags: ["companies"]
---

# One employer.

`GET /v1/companies/{slug}`

## Request

- Base URL: `https://api.jobopportunitiesapi.org`
- URL: `https://api.jobopportunitiesapi.org/v1/companies/{slug}`
- Auth: HTTP bearer

## Path parameters

- `slug` string, required

## Response `200`

The company.

- object
  - `data` Company
    - `careers_url` string
    - `country` string
    - `first_seen` string
    - `industry` string
    - `logo` string
    - `name` string
    - `open_roles` integer: Roles retrievable from THIS API. Never a number the API cannot honour.
    - `org_type` string
    - `own_site_roles` integer: Vacancies seen on the company own careers page.
    - `sectors` string[]
    - `slug` string
    - `source_types` string[]: `aggregator` and `agency` are reserved and match no rows today; see the source_type enum.
    - `website` string
    - `website_verified` string: When we fetched this domain and found the company own name on it.

## Other responses

- `401`: Missing, unknown, revoked or expired key. All four are reported identically.
- `402`: The plan's monthly RECORD allowance is spent. Distinct from 429: a 429 means slow down and retry, a 402 means the licence is used up until the allowance resets. The monthly window is the CALENDAR month in UTC: it resets on the 1st of the next month at 00:00 UTC, and the body gives the exact instant. Do not retry before then. Every metered response carries `X-RateLimit-Records-Remaining` and `X-RateLimit-Records-Reset` (the reset instant, Unix seconds), so this is visible long before it happens.
- `404`: No such row.
- `429`: Over your plan's per-minute or per-day limit. `Retry-After` says how long (seconds to the next minute boundary, or to UTC midnight on a daily breach). The body says exactly when the limit resets (`resets_at`, `resets_at_text`) and, when a higher plan exists, links a same-key upgrade (`upgrade_url`).

---

[API](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api.md) · [All operations](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jobopportunitiesapi/apis/job-opportunities-api/revisions/b5ef9709a0c9?raw)