---
title: "Search employers by name. Each result carries its PERM record and its page's name for /employers/{slug}."
method: GET
path: "/employers"
---

# Search employers by name. Each result carries its PERM record and its page's name for /employers/{slug}.

`GET /employers`

## Request

- Base URL: `https://permtracker.app/v1`
- URL: `https://permtracker.app/v1/employers`
- Auth: HTTP bearer

## Query parameters

- `q` string, required
- `limit` string

## Response `200`

The answer, with `meta.source`, `meta.asOf` and `meta.url` naming where it came from.

- object
  - `data` unknown
  - `meta` object

## Other responses

- `400`: The request isn't valid. Not counted.
- `401`: No key, or a key we don't recognise.
- `404`: No such record. Counted.
- `429`: A minute, day or month limit. Retry-After says when it lifts.

---

[API](https://skmtc.dev/permtracker/apis/perm-tracker-api.md) · [All operations](https://skmtc.dev/permtracker/apis/perm-tracker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/permtracker/apis/perm-tracker-api/revisions/9f3b735c0dca?raw)