---
title: "A company's hiring velocity and momentum"
method: GET
path: "/v1/companies/{company_id}/hiring-pulse"
---

# A company's hiring velocity and momentum

`GET /v1/companies/{company_id}/hiring-pulse`

## Request

- Base URL: `https://api.reqbeat.com`
- URL: `https://api.reqbeat.com/v1/companies/{company_id}/hiring-pulse`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

A company's hiring velocity/direction/momentum in one call -- the first
paid route, honoring `max_age` (seconds). Cold (no ATS/board data at
all, and `max_age` demands freshness beyond nothing) returns `202
{job_id, status: "crawling"}` instead of a synchronous body.

Requires the `read` scope.

## Path parameters

- `company_id` integer, required: The plane's company id -- returned as `company_id` by /v1/reqs/search and by every company motion response.

## Query parameters

- `max_age` integer, nullable: Maximum acceptable data age in SECONDS. A company with no data fresh enough returns 202 {job_id, status: 'crawling'} instead of a pulse body.

## Headers

- `Idempotency-Key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: No API key was sent.
- `402`: The key is over its plan's rolling call quota, or the account is past its spend cap. `upgrade_url` and `purchase_url` are the ways out.
- `403`: The presented key is invalid or revoked, or (see `x-required-scope` on this operation) it does not carry the scope this operation requires.
- `422`: Validation Error
- `429`: Too many calls in the current 60-second window. The limit is per API key, set by the key's plan, and shared by every metered REST route and MCP tool; the shared demo key is limited per IP address instead. Wait `Retry-After` seconds and retry. The `RateLimit-*` headers are absent when `reason` is `key_throttled`.

---

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