Skip to main content
​
business_id
string<biz_string>
required

The id of the Business

Example:

"biz_R2fAXCjqJPdpYata112zyW"

​
name
string
required

The original file name

Maximum string length: 255
Example:

"receipt.pdf"

​
description
string
required

The description of the Document

Maximum string length: 255
Example:

"Receipt"

​
document_type
enum<string>
required

The type of the Document.

Available options:
receipt,
statement,
other,
payroll,
bill,
mileage,
invoice
Examples:

"receipt"

"statement"

"other"

​
file_size
integer
required

The size of the file in kilobytes

Example:

1024

​
status
enum<string>
required

The status of the Document

Available options:
processing,
processed,
partially_processed,
failed
​
external_account_id
string<uuid> | null
required
​
transaction_id
string<uuid> | null
required
​
id
string<doc_string>
required

The id of the Document

Example:

"doc_R2fAXCjqJPdpYata112zyW"

​
created_at
string<date-time>
required

The datetime the Document was created in UTC ISO-8601 format

​
task_id
string<tsk_string> | null

The id of the Task

Example:

"tsk_R2fAXCjqJPdpYata112zyW"

​
source
enum<string>
default:manual_upload

The ingest channel the Document arrived through

Available options:
manual_upload,
email,
integration
Examples:

"manual_upload"

"email"

"integration"

​
external_id
string | null

External identifier for deduplication (e.g., provider payroll ID)

Maximum string length: 255
Example:

"gusto-payroll-abc123"

​
metadata_
Metadata · object | null
​
journal_entry_ids
string<je_string>[] | null

The ids of the Journal Entries associated with the document

Example:

"je_R2fAXCjqJPdpYata112zyW"

​
external_account_ids
string<eac_string>[] | null

The ids of the External Accounts associated with the document

Example:

"eac_R2fAXCjqJPdpYata112zyW"

​
transaction_ids
string<txn_string>[] | null

The ids of the Transactions associated with the document

Example:

"txn_R2fAXCjqJPdpYata112zyW"

​
status_reason
string | null

Human-readable reason when the document has the failed status

​
failure_code
string | null

The code of the failure when the document has the failed status

​
bill_id
string<bil_string> | null

The id of the Bill associated with the document

Example:

"bil_R2fAXCjqJPdpYata112zyW"

​
invoice_id
string<inv_string> | null

The id of the Invoice associated with the document

Example:

"inv_R2fAXCjqJPdpYata112zyW"