---
title: "Employer profile companion table - one row per employer with live postings"
method: GET
path: "/api/v1/employers.php"
tags: ["Employer profile"]
---

# Employer profile companion table - one row per employer with live postings

`GET /api/v1/employers.php`

## Request

- Base URL: `https://veritahire.com`
- URL: `https://veritahire.com/api/v1/employers.php`
- Auth: API key in header `X-API-Key`

Joins to postings on employer_id. No field is inferred by a model: every non-null value has an evidence row naming its source (People Data Labs free company dataset CC BY 4.0 joined on the employer domain, SEC EDGAR, or the employer's own pages). Each row counts as one record against the monthly quota.

## Query parameters

- `after` integer
- `limit` integer
- `id` integer
- `hq_state` string
- `org_kind` string
- `size` string
- `industry` string
- `public` integer
- `platform` string

## Response `200`

Employer rows

- EmployersPage
  - `data` EmployerRow[]
    - `employer_id` integer
    - `employer` string
    - `live_postings` integer
    - `platform` string, nullable
    - `org_kind` string, nullable
    - `industry` string, nullable
    - `size_range` string, nullable
    - `hq_city` string, nullable
    - `hq_state` string, nullable
    - `hq_country` string, nullable
    - `founded_year` integer, nullable
    - `website` string, nullable
    - `linkedin_url` string, nullable
    - `ticker` string, nullable
    - `exchange` string, nullable
    - `cik` integer, nullable
    - `sic` integer, nullable
    - `sic_label` string, nullable
    - `state_inc` string, nullable
    - `latest_10k_date` string, date, nullable
    - `latest_10k_url` string, nullable
    - `profile_sources` object, nullable: The source of every non-null field: pdl (People Data Labs, CC BY 4.0), sec (SEC EDGAR), or the employer's own page.
  - `count` integer
  - `next_after` integer, nullable
  - `quota` Quota
    - `used` integer
    - `limit` integer, nullable
    - `resets` string, nullable

## Other responses

- `401`: Missing or bad key
- `429`: Rate limited or quota exceeded

---

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