v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Finance > FinancialDocument

Reads a single Financial document

Fetch one or all financial documents for the company.

get/api/2026-07-01/resources/finance/financial_documents/{id}

Path parameters

idstring required

Search financial documents by ID

Response

idstring required

Factorial unique identifier.

net_amount_centsinteger

Net amount in cents.

total_amount_centsinteger

Total amount in cents.

document_numberstring

Document number.

currencystring

Document currency.

status'processing' | 'review' | 'sent_to_pay' | 'paid' required

Current status.

due_datestring

Due date.

document_datestring

Document date.

legal_entity_idstring

Factorial unique identifier for the legal entity of the financial document.

vendor_idstring

Factorial unique identifier for the vendor of the financial document.

fileobject

File attached.

updated_atstring required

Updation date.

fully_reconciled_atstring

Date when was fully reconciled.

recorded_atstring

Date when was recorded.

duplicate_financial_document_idstring

Factorial unique identifier for the duplicate financial document.

validated_atstring

Date when was validated.

validated_by_idstring

Factorial unique identifier for the user who validated the financial document.

document_type'invoice' | 'receipt' | 'credit_note' required

Type of the financial document. Using "invoice" as default.

parent_financial_document_idstring

Factorial unique identifier for the parent financial document of the financial document.

taxes_total_amount_centsinteger

Taxes total amount in cents.

issuer_namestring

Name of the entity issuing the financial document.

issuer_address_line_1string

First line of the issuer's address.

issuer_address_line_2string

Second line of the issuer's address.

issuer_citystring

City of the issuer's address.

issuer_postal_codestring

Postal code of the issuer's address.

issuer_statestring

State or province of the issuer's address.

issuer_country_codestring

Country code of the issuer's address.

issuer_tax_idstring

Tax identification number of the issuer.

recipient_namestring

Name of the entity receiving the financial document.

recipient_address_line_1string

First line of the recipient's address.

recipient_address_line_2string

Second line of the recipient's address.

recipient_citystring

City of the recipient's address.

recipient_postal_codestring

Postal code of the recipient's address.

recipient_statestring

State or province of the recipient's address.

recipient_country_codestring

Country code of the recipient's address.

recipient_tax_idstring

Tax identification number of the recipient.

Example response

{
  "id": "135",
  "net_amount_cents": 10000,
  "total_amount_cents": 11210,
  "document_number": "INV-135",
  "currency": "USD",
  "status": "review",
  "due_date": "2020-01-01",
  "document_date": "2020-01-01",
  "legal_entity_id": "13",
  "vendor_id": "33",
  "file": {
    "id": 1,
    "filename": "invoice.pdf",
    "url": "https://factorial.com/invoice.pdf",
    "size": 1024,
    "content_type": "application/pdf",
    "created_at": "2020-01-01T00:00:00.000Z"
  },
  "updated_at": "2020-01-01T00:00:00.000Z",
  "taxes": [
    {
      "amount_cents": 1210,
      "base_amount_cents": 10000,
      "percentage": 0.21,
      "type": "vat",
      "tax_rates": [
        {
          "percentage": 21
        }
      ]
    }
  ],
  "fully_reconciled_at": "2020-01-01T00:00:00.000Z",
  "recorded_at": "2020-01-01T00:00:00.000Z",
  "validated_at": "2020-01-01T00:00:00.000Z",
  "validated_by_id": "31",
  "document_type": "invoice",
  "parent_financial_document_id": "135",
  "taxes_total_amount_cents": 1210,
  "issuer_name": "Acme Corporation",
  "issuer_address_line_1": "123 Main Street",
  "issuer_address_line_2": "Suite 100",
  "issuer_city": "San Francisco",
  "issuer_postal_code": "94105",
  "issuer_state": "California",
  "issuer_country_code": "US",
  "issuer_tax_id": "US123456789",
  "recipient_name": "XYZ Company",
  "recipient_address_line_1": "456 Market Street",
  "recipient_address_line_2": "Floor 5",
  "recipient_city": "New York",
  "recipient_postal_code": "10001",
  "recipient_state": "New York",
  "recipient_country_code": "es",
  "recipient_tax_id": "B66854530"
}