---
title: "Per-employer daily hiring velocity (new / retired / live)"
method: GET
path: "/api/v1/velocity.php"
tags: ["Hiring velocity"]
---

# Per-employer daily hiring velocity (new / retired / live)

`GET /api/v1/velocity.php`

## Request

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

Either one employer's full series (employer_id, optional from/to) or every employer for one day (date, cursor-paged by employer_id). The identity live(d) = live(d-1) + new(d) - retired(d) holds exactly. partial = 1 on days before 2026-06-29 where retirements are incomplete. Each row counts as one record against the monthly quota.

## Query parameters

- `employer_id` integer
- `from` string, date
- `to` string, date
- `date` string, date
- `after` integer
- `limit` integer

## Response `200`

Velocity rows

- VelocityPage
  - `data` VelocityRow[]
    - `employer_id` integer
    - `employer` string
    - `date` string, date
    - `new_postings` integer
    - `retired_postings` integer
    - `live_postings` integer
    - `partial` integer
  - `count` integer
  - `next_after` integer, nullable
  - `quota` Quota
    - `used` integer
    - `limit` integer, nullable
    - `resets` string, nullable

## Other responses

- `401`: Missing, unknown or revoked key
- `429`: Per-minute limit or monthly quota reached

---

[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)