Response headers

Headers carry metering, pagination, and diagnostic state so you rarely need to parse the body to make a routing decision. This page is the canonical reference — other pages link here instead of repeating the tables.

Rate limiting

Set on every authenticated response, with one exception noted below.

Header	Meaning
`X-RateLimit-Limit`	Maximum requests allowed in the current window.
`X-RateLimit-Remaining`	Requests remaining in the current window. Never negative.
`X-RateLimit-Used`	Requests already consumed in the current window.
`X-RateLimit-Reset`	Unix epoch seconds when the current window resets. Only present when a reset time is known — typically once you are being tracked against a window, and always on `429`. Do not assume it is on every response; fall back to `Retry-After`, or to your own backoff, when it is absent.
`X-RateLimit-Group`	Which rate-limit group’s budget applied — `Default`, `JobSearch`, `JobFeed`, `Geocode`, `AutoApply`, or `AutoApplyManagement`.
`Retry-After`	Seconds to wait before retrying. Set on `429` and `503` only.

Wallet and job settlement

Set when wallet or included-jobs settlement is relevant. They are omitted on free endpoints and may be omitted when no jobs are delivered.

Header	Set on
`X-Credits-Deducted`	Credits charged to the wallet for this response. `0` when included jobs cover every delivered job; absent when the Unlimited plan covers the product.
`X-Credits-Balance`	A wallet debit, and on `402`. Your balance after the debit or the failed precheck.
`X-Credits-Required`	`402` only. Credits the request would have needed to succeed.
`X-Billing-Status`	Rare best-effort outcome: `Failed` when a concurrent balance change prevented a confirmed debit, or `Unconfirmed` when wallet infrastructure failed after settlement began. Do not automatically replay an `Unconfirmed` delivery.

See Billing for how debits and precharges work.

Included jobs

Set on Search and Feed responses when a Job Search plan’s included jobs apply. The same remaining value is also used by dashboard Export and Outbound. The header names keep their historical X-Quota-* wire names — in these docs and the dashboard, the numbers they carry are your included jobs.

Header	Meaning
`X-Quota-Limit`	The plan’s total included jobs across Search, Feed, Export, and Outbound.
`X-Quota-Remaining`	Included jobs left in the current period after this response.

Page-based pagination

Set on GET /api/jobs, POST /api/jobs/search, GET /api/companies/{id}/jobs.

Header	Meaning
`X-Total-Count`	Total matching records across all pages.
`X-Total-Pages`	Total number of pages at the current `page_size`.
`X-Page`	The page returned.
`X-Page-Size`	The page size used.

See Pagination for request parameters and limits.

Cursor pagination

Set on POST /api/jobs/feed, POST /api/jobs/feed/managed, GET /api/jobs/expired.

Header	Meaning
`X-Has-More`	`true` if another page is available via `next_cursor` in the body.

Idempotency

Header	Meaning
`X-Idempotent-Replay`	Present when the response was replayed from a stored result rather than executed. Absent on a fresh execution.

See Idempotency for the full contract.

Diagnostics

Header	Set on
`x-correlation-id`	Every response. The id to quote in support requests. See Errors.
`WWW-Authenticate`	`401` only. `ApiKey realm="api.jobo.world"`.

Caching

Set only on GET /api/companies/{id}.

Header	Meaning
`Cache-Tag`	An opaque tag used for targeted CDN invalidation when the company record changes.
`Cloudflare-CDN-Cache-Control`	A long CDN TTL on a hit; 60s on a `404`.
`Cache-Control: no-store`	Tells browsers not to retain the response locally.

This is why the endpoint is fast and never charges the wallet — most requests are served from the CDN edge, not your included jobs. See Rate limits for the free-but-uncharged note.

X-RapidAPI-Billing appears only on requests routed through the RapidAPI marketplace. It is not part of the direct connect.jobo.world contract — ignore it unless you sell through that channel.

Worked example

A search response covered by a Job Search plan’s included jobs:

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 360
X-RateLimit-Remaining: 358
X-RateLimit-Used: 2
X-RateLimit-Reset: 1753564800
X-RateLimit-Group: JobSearch
X-Quota-Limit: 10000
X-Quota-Remaining: 9975
X-Credits-Deducted: 0
X-Total-Count: 214
X-Total-Pages: 9
X-Page: 1
X-Page-Size: 25
x-correlation-id: 989f012bca1b4a0a994aa583efaa8f5d

Overview

API essentials

Jobs

Feed

Companies

Locations

Auto Apply — Preview

Rate limiting

Wallet and job settlement

Included jobs

Idempotency

Diagnostics

Caching

Worked example

​Rate limiting

​Wallet and job settlement

​Included jobs

​Page-based pagination

​Cursor pagination

​Idempotency

​Diagnostics

​Caching

​Worked example

Rate limiting

Wallet and job settlement

Included jobs

Page-based pagination

Cursor pagination

Idempotency

Diagnostics

Caching

Worked example