Skip to navigation
API ReferenceAward DatasetsList summary generation records

List summary generation records

Published summary-generation collection. Existing generic route with a concrete dataset name. Requires data:read. Build-scoped positional identity; at most 10,000 positions per query. Check truncated. Text search is unavailable; omit q.

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.

filtersstringOptional

URL-encoded JSON object; exact equality on up to 12 published fields, AND-combined. Primitive or null values only; strings at most 500 characters. No range, array-containment, OR or sort operators. Allowed fields: id, created_at, source_data_as_of, receipt_sha256.

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.

truncatedbooleanOptional

True when more matches exist past the 10,000-position cap. Narrow exact filters; null next_cursor alone does not prove a complete export.

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