Skip to main content
GET
/
contents
/
v1
/
documents
/
{content_id}
Get document
curl --request GET \
  --url https://api.bigdata.com/contents/v1/documents/{content_id} \
  --header 'X-API-KEY: <api-key>'
{
  "id": "E0618D0E9D3A960C1731A620EDE56B5C",
  "file_name": "Weekly summary report.eml",
  "user_id": "user_id_001",
  "org_id": "org_id_001",
  "rp_collection_id": "2CBDC7DA8AE42A8A078DECC3C9FCADFB",
  "raw_size": 18974,
  "request_origin": "email",
  "content_type": "message/rfc822",
  "status": "completed",
  "shared_with_orgs": [
    "org_id_001"
  ],
  "created_at": "2026-02-03T08:43:02.729356Z",
  "updated_at": "2026-02-03T08:43:02.729359Z",
  "connector_id": "019a9612-bfad-758c-884e-37dd8c6ad2cb",
  "error_code": null,
  "delete_started_ts": null,
  "file_metadata": null,
  "tags": [
    {
      "id": "019a48b4-e574-71d9-a8d9-6a5a86386847",
      "name": "to:user@email.com"
    },
    {
      "id": "019a48b4-e573-7203-945a-2e7c4c164217",
      "name": "from:user@email.com"
    }
  ]
}

Authorizations

​
X-API-KEY
string
header
required

Your API key. Include it in every request as the X-API-KEY header. Create and manage keys in the Developer Platform.

Path Parameters

​
content_id
string
required

Content ID of the document: a 32-character uppercase hexadecimal string (MD5-based identifier).

Example:

"E0618D0E9D3A960C1731A620EDE56B5C"

Response

Document metadata (id, file_name, status, connector_id, tags, etc.). Use Get annotated document or Get original document with this id to download content.

Metadata for a single document. Returned by List documents and Get document. Use the id (content_id) with Get annotated document or Get original document to retrieve the file content.

​
id
string
required

Content ID: unique 32-character uppercase hexadecimal identifier for the document. Use this when calling Get document, Get annotated document, or Get original document.

Example:

"E0618D0E9D3A960C1731A620EDE56B5C"

​
file_name
string
required

Original file name of the uploaded document.

Example:

"Weekly summary report.eml"

​
user_id
string
required

ID of the user who uploaded the document.

Example:

"user_id_001"

​
org_id
string
required

ID of the organization the document belongs to.

Example:

"org_id_001"

​
status
enum<string>
required

Processing status of the document.

Available options:
pending,
processing,
completed,
failed
​
created_at
string<date-time>
required

Timestamp when the document was created.

Example:

"2026-02-03T08:43:02.729356Z"

​
updated_at
string<date-time>
required

Timestamp when the document was last updated.

Example:

"2026-02-03T08:43:02.729359Z"

​
rp_collection_id
string

ID of the collection the document belongs to. This is applicable only for emails and attachments.

Example:

"2CBDC7DA8AE42A8A078DECC3C9FCADFB"

​
raw_size
integer

Size of the raw document in bytes.

Example:

18974

​
request_origin
string

Origin of the content ingestion request (e.g., 'email').

​
content_type
string

MIME type of the document.

Example:

"message/rfc822"

​
shared_with_orgs
string[]

List of organization IDs the document is shared with.

Example:
["org_id_001"]
​
connector_id
string<uuid>

ID of the connector used to upload the document.

Example:

"019a9612-bfad-758c-884e-37dd8c6ad2cb"

​
error_code
string | null

Error code if the document processing failed.

Example:

null

​
delete_started_ts
string<date-time> | null

Timestamp when document deletion started, if applicable.

Example:

null

​
file_metadata
object

Additional metadata about the file.

Example:

null

​
tags
object[]

Tags associated with the document.