Sign in
Documents

List documents

List documents with cursor-based pagination.

get/v1beta/documents

Query parameters

page_tokenstring

Opaque pagination token from a previous response. Pass next_page_token or prev_page_token from a previous response to continue pagination. Empty or omitted for the first page.

Example:eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0

Opaque pagination token from a previous response. Pass next_page_token or prev_page_token from a previous response to continue pagination. Empty or omitted for the first page.

page_sizeinteger

Maximum number of items to return per page (1-100). Default: 50.

Maximum number of items to return per page (1-100). Default: 50.

created_by_idstring[]

Filter by creator ID(s). Returns documents matching ANY of the specified IDs.

access_levelstring[]

Filter by access level(s). Returns documents matching ANY of the specified levels.

processing_statusstring[]

Filter by processing status(es). Returns documents matching ANY of the specified statuses.

created.afterstring date-time

Filter by created.after (RFC 3339 format, e.g., 2024-01-15T09:30:00Z)

Response

Success

Example response

{
  "items": [
    {
      "created_by": {
        "id": "user_01h2xcejqtf2nbrexx3vqjhp41"
      },
      "current_version": {
        "id": "ver_01h2abcd1234efgh5678jkmnpt"
      },
      "description": "Quarterly financial report for Q4 2024",
      "id": "doc_01h2xcejqtf2nbrexx3vqjhp41",
      "title": "Q4 2024 Financial Report",
      "url": "https://app.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41"
    }
  ],
  "pagination": {
    "next_page_token": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0",
    "prev_page_token": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJwcmV2In0"
  }
}

Changes