Documents
List documents
Retrieves a paginated list of documents with optional filtering by status, assignee, parent, and other criteria.
GET
/
v0
/
documents
Copy
curl --request GET \
--url https://api.avidoai.com/v0/documents \
--header 'x-api-key: <api-key>'
Copy
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000",
"children": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000"
}
],
"parent": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000"
}
}
],
"pagination": {
"skip": 0,
"limit": 25,
"total": 100,
"totalPages": 4
}
}
Authorizations
Your unique Avido API key
Query Parameters
Number of items to skip
Required range:
x >= 0
Example:
0
Number of items per page
Required range:
1 <= x <= 100
Example:
25
Field to order by
Example:
"createdAt"
Order direction
Available options:
asc
, desc
Example:
"desc"
Filter by document status
Available options:
DRAFT
, REVIEW
, APPROVED
, ARCHIVED
Example:
"APPROVED"
Filter by assignee user ID
Example:
"user_123456789"
Filter by parent document ID
Example:
"456e4567-e89b-12d3-a456-426614174000"
Filter by scrape job ID
Example:
"321e4567-e89b-12d3-a456-426614174000"
Response
200
application/json
Successfully retrieved documents
Paginated response containing documents
Copy
curl --request GET \
--url https://api.avidoai.com/v0/documents \
--header 'x-api-key: <api-key>'
Copy
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000",
"children": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000"
}
],
"parent": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"title": "API Documentation",
"content": "This document describes the API endpoints...",
"metadata": {},
"language": "english",
"originalSentences": [
"This is the first sentence.",
"This is the second sentence."
],
"status": "APPROVED",
"assignee": "user_123456789",
"scrapeJob": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2024-01-05T12:34:56.789Z",
"modifiedAt": "2024-01-05T12:34:56.789Z",
"orgId": "org_123456789",
"initiatedBy": "user_123456789",
"name": "Documentation Scrape",
"url": "https://docs.example.com",
"pages": {},
"status": "COMPLETED"
},
"scrapeJobId": "321e4567-e89b-12d3-a456-426614174000"
}
}
],
"pagination": {
"skip": 0,
"limit": 25,
"total": 100,
"totalPages": 4
}
}
Assistant
Responses are generated using AI and may contain mistakes.