Skip to navigation
API ReferenceAwards and JobsList jobs

List jobs

Job postings DefDex observed on company career pages, newest first: a dated sample, not a live vacancy list. Needs company, q or location. 1 credit per page. At most 1,000 results per query; past that the page says truncated and points to hello@defdex.io for bulk data.

Authentication

AuthorizationBearer

Create a key at https://app.defdex.io/developer/keys. Keep it private.

Query parameters

companystringOptional<=200 characters

Organization id or slug; includes its subsidiaries.

qstringOptional<=200 characters
Job title contains this text.
locationstringOptional<=200 characters
Location contains this text.
statusenumOptional
open, closed or unknown.
Allowed values:
limitintegerOptional1-100Defaults to 25

Results per page, 1–100 (default 25). Each page costs 1 credit.

cursorstringOptional<=4000 characters

next_cursor from the previous page. Keep the other parameters unchanged.

Response headers

X-Request-IdstringOptional
Support identifier on admitted requests.
X-Credits-RemainingstringOptional
Credits left after this call.

Response

Success
datalist of objects
next_cursorstring or null
build_idstring
The published build this page came from.
truncatedbooleanOptional

True when more than 1,000 results match. Narrow the filters, or email hello@defdex.io for a bulk dataset.

bulkobjectOptional

Present when a query hits the 1,000-result cap or has no filter.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
503
Service Unavailable Error