200

Not an error

Success — including "not found" — The request worked. This also covers a missing single object and an empty list result.

Response body

{ … } · {} · { "data": [] }

Should you retry?

This is a success status. Nothing to retry.

What it means

The API prefers empty results over 404s. A single-object endpoint returns 200 {} when the item does not exist or is not in your scope, and a list endpoint returns 200 with an empty data array.

Common causes

The job or company genuinely does not exist, or is no longer active.
It belongs to a company you have blocked, or it is a job you have hidden.
Your filters excluded everything — including a `collections` value that resolves to no sources, which matches nothing rather than everything.

How to fix it

Check for emptiness explicitly rather than branching on a 404 that never arrives. If you expected results, check your suppression first — GET /v4/sources/blocked and GET /v4/jobs/hidden list what your organization is filtering out, and both are free to call.

Endpoints that return this

Read from the OpenAPI specification, so this list cannot claim an endpoint returns a status the contract does not list.

Method	Endpoint	What it does
GET	/v4/jobs	Search jobs
GET	/v4/jobs/search	Search jobs (alias of /v4/jobs)
GET	/v4/jobs/options	Job facet values
GET	/v4/jobs/{job_id}	One job by global id
GET	/v4/autocomplete/titles	Job-title suggestions
GET	/v4/autocomplete/sources	Source (company) suggestions
GET	/v4/sources	Search sources (companies)
GET	/v4/sources/search	Search sources (alias of /v4/sources)
GET	/v4/sources/options	Source facet values
GET	/v4/sources-id/{source_id}	One source by id
GET	/v4/sources-url/{url_source}	One source by URL
GET	/v4/sources-id/{source_id}/jobs	A source's jobs (by id)
GET	/v4/sources/{url_source}/jobs	A source's jobs (by URL)
GET	/v4/sources-id/{source_id}/related	Related sources (by id)
GET	/v4/sources/{url_source}/related	Related sources (by URL)
GET	/v4/jobs/hidden	Jobs you have hidden
POST	/v4/jobs/hidden/{job_id}	Hide a job
DELETE	/v4/jobs/hidden/{job_id}	Un-hide a job
GET	/v4/sources/blocked	Companies you have blocked
POST	/v4/sources/blocked/{source_id}	Block a company
DELETE	/v4/sources/blocked/{source_id}	Unblock a company
GET	/v4/me	Your plan and current quota
GET	/v4/usage	Daily usage history
POST	/mcp	MCP server (JSON-RPC 2.0)

200