Skip to main content
GET
/
api
/
documents
List documents visible to you
curl --request GET \
  --url https://api.example.com/api/documents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filename": "<string>",
    "owner": "<string>",
    "mime_type": "<string>",
    "size_bytes": 123,
    "page_count": 123,
    "chunk_count": 123,
    "subtype": "<string>",
    "datahub_urn": "<string>",
    "extraction_warning": "<string>",
    "suggested_summary": "<string>",
    "error": "<string>",
    "s3_key": "<string>",
    "suggested_tags": [
      {
        "name": "<string>",
        "is_existing": false,
        "urn": "<string>"
      }
    ],
    "suggested_glossary_terms": [
      {
        "name": "<string>",
        "is_existing": false,
        "urn": "<string>"
      }
    ],
    "suggested_domain": {
      "name": "<string>",
      "is_existing": false,
      "urn": "<string>"
    }
  }
]

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

limit
integer
default:100

Response

Successful Response

id
string<uuid>
required
filename
string
required
owner
string
required
mime_type
string
required
size_bytes
integer
required
page_count
integer | null
required
chunk_count
integer | null
required
subtype
string | null
required
status
enum<string>
required

Lifecycle status of an ingested document.

Available options:
uploading,
extracting,
ocr_required,
indexed,
failed
enrichment_status
enum<string>
required

Crew-driven enrichment lifecycle.

Available options:
pending,
running,
awaiting_review,
confirmed,
failed
datahub_urn
string | null
required
extraction_warning
string | null
required
suggested_summary
string | null
required
error
string | null
required
s3_key
string | null
required
suggested_tags
SuggestionItem · object[]
suggested_glossary_terms
SuggestionItem · object[]
suggested_domain
SuggestionItem · object

A flagged enrichment suggestion for a tag, glossary term, or domain.