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

Set only when metering is relevant — omitted on unmetered endpoints and on zero-debit responses.

Header	Set on
`X-Credits-Deducted`	A wallet debit. Credits consumed by this specific request.
`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.

See Billing for how debits and precharges work.

Subscription quota

Set when a package with an included allowance applies to the request.

Header	Meaning
`X-Quota-Limit`	The package’s included allowance for this request type.
`X-Quota-Remaining`	Allowance left in the current period.

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 does not deduct wallet credits — most requests are served from the CDN edge, not your quota. 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 metered search response, paginated, under a subscription package:

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-Credits-Deducted: 25
X-Credits-Balance: 4975
X-Quota-Limit: 10000
X-Quota-Remaining: 9998
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

Subscription quota

Idempotency

Diagnostics

Caching

Worked example

​Rate limiting

​Wallet

​Subscription quota

​Page-based pagination

​Cursor pagination

​Idempotency

​Diagnostics

​Caching

​Worked example

Rate limiting

Wallet

Subscription quota

Page-based pagination

Cursor pagination

Idempotency

Diagnostics

Caching

Worked example