List documents
Retrieves a paginated list of documents with optional filtering by status, assignee, parent, and other criteria. Only returns documents with active approved versions unless otherwise specified.
Authorizations
Your unique Avido API key
Your unique Avido Application ID
Query Parameters
Number of items to skip before starting to collect the result set.
0 <= x <= 90071992547409910
Number of items to include in the result set.
1 <= x <= 10025
Field to order the result set by.
createdAt, modifiedAt, type, assignee, id "createdAt"
Order direction.
asc, desc "desc"
Filter by document type. Defaults to KNOWLEDGE when omitted.
KNOWLEDGE, POLICY "KNOWLEDGE"
Filter by document-level status (DocumentV2.status). When omitted, the API defaults to ACTIVE for library queries and skips the filter for quickstart-scoped queries (so DRAFT KB-Review uploads remain visible). Distinct from status below which filters the document's active version status.
DRAFT, ACTIVE "ACTIVE"
Filter by document version status (filters documents by their active version status). Supports multiple values.
Status of the document. Valid options: DRAFT, REVIEW, APPROVED, ARCHIVED, ACTIVE.
DRAFT, REVIEW, APPROVED, ARCHIVED, ACTIVE "APPROVED"
Filter documents by tag ID
"789e4567-e89b-12d3-a456-426614174000"
Search in document version title and content
"API documentation"
Filter by scrape job ID. Supports multiple values.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"321e4567-e89b-12d3-a456-426614174000"
Filter by source FileProcessing ID (the row that ingested the doc). Supports multiple values, capped at 100.
100^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"654e7890-e89b-12d3-a456-426614174000"
Filter documents by topic ID
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"789e1234-e89b-12d3-a456-426614174000"
Filter by assignee user ID
"user_123456789"
Filter documents created after this date (inclusive).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$"2024-01-01T00:00:00.000Z"
Filter documents created before this date (inclusive).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$"2024-12-31T23:59:59.999Z"
Filter documents linked to a specific quickstart.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"456e7890-e89b-12d3-a456-426614174001"
Filter documents whose active version metadata contains this step value.
64"KNOWLEDGE_BASE_REVIEW"