Skip to navigation
API ReferenceAward Convenience AccessList awards

List awards

Convenience view of published awards. Obligations and ceilings are separate. company_id filters ultimate_parent_id. q searches title only. Requires data:read.

Authentication

AuthorizationBearer

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

Query parameters

limitintegerOptional1-100Defaults to 25
Maximum records per page.
cursorstringOptional<=12000 characters

Opaque next_cursor from the preceding page. Keep dataset, q and filters unchanged.

qstringOptional<=200 characters

Case-insensitive substring on available name, title, description, summary or recipient_name fields; no ranked or fuzzy search.

company_idstringOptionalformat: "uuid"

Response headers

X-Request-IdstringOptional
Support identifier on admitted requests.

Response

Success
datalist of objects
next_cursorstring or null
build_idstring

Publication observed for this response; compare across related reads.

Errors

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