v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Finance > FinancialDocument

Reads all Financial documents

Fetch one or all financial documents for the company.

get/api/2026-07-01/resources/finance/financial_documents

Query parameters

company_idstring

Search financial documents by company_id

Example:1

Search financial documents by company_id

ids[]string[]

Search financial documents by ID

[
  "135"
]

vendor_idstring

Search financial documents by vendor_id

Example:33

Search financial documents by vendor_id

currencystring

Search financial documents by currency

Example:USD

Search financial documents by currency

statuses[]string[]

Search financial documents by status

[
  "review"
]

legal_entity_ids[]string[]

Search financial documents by legal_entity_id

[
  "13"
]

document_types[]string[]

Search financial documents by document_type

[
  "invoice"
]

updated_fromstring

Filter financial documents updated from a specific date

Example:2020-01-01

Filter financial documents updated from a specific date

Response

Example response

{
  "data": [
    {
      "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"
    }
  ]
}