---
title: "Reads all Financial documents"
method: GET
path: "/api/2026-07-01/resources/finance/financial_documents"
tags: ["Finance > FinancialDocument"]
---

# Reads all Financial documents

`GET /api/2026-07-01/resources/finance/financial_documents`

Fetch one or all financial documents for the company.

## Query parameters

- `company_id` string — Search financial documents by company_id
- `ids[]` string[] — Search financial documents by ID
- `vendor_id` string — Search financial documents by vendor_id
- `currency` string — Search financial documents by currency
- `statuses[]` string[] — Search financial documents by status
- `legal_entity_ids[]` string[] — Search financial documents by legal_entity_id
- `document_types[]` string[] — Search financial documents by document_type
- `updated_from` string — Filter financial documents updated from a specific date

## Response `200`

OK

- object
  - `data` FinanceFinancialDocument[]
    - `id` string, required — Factorial unique identifier.
    - `net_amount_cents` integer — Net amount in cents.
    - `total_amount_cents` integer — Total amount in cents.
    - `document_number` string — Document number.
    - `currency` string — Document currency.
    - `status` 'processing' | 'review' | 'sent_to_pay' | 'paid', required — Current status.
    - `due_date` string — Due date.
    - `document_date` string — Document date.
    - `legal_entity_id` string — Factorial unique identifier for the legal entity of the financial document.
    - `vendor_id` string — Factorial unique identifier for the vendor of the financial document.
    - `file` object — File attached.
    - `updated_at` string, required — Updation date.
    - `taxes` unknown[], required — Taxes.
      - unknown
    - `fully_reconciled_at` string — Date when was fully reconciled.
    - `recorded_at` string — Date when was recorded.
    - `duplicate_financial_document_id` string — Factorial unique identifier for the duplicate financial document.
    - `validated_at` string — Date when was validated.
    - `validated_by_id` string — 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_id` string — Factorial unique identifier for the parent financial document of the financial document.
    - `taxes_total_amount_cents` integer — Taxes total amount in cents.
    - `issuer_name` string — Name of the entity issuing the financial document.
    - `issuer_address_line_1` string — First line of the issuer's address.
    - `issuer_address_line_2` string — Second line of the issuer's address.
    - `issuer_city` string — City of the issuer's address.
    - `issuer_postal_code` string — Postal code of the issuer's address.
    - `issuer_state` string — State or province of the issuer's address.
    - `issuer_country_code` string — Country code of the issuer's address.
    - `issuer_tax_id` string — Tax identification number of the issuer.
    - `recipient_name` string — Name of the entity receiving the financial document.
    - `recipient_address_line_1` string — First line of the recipient's address.
    - `recipient_address_line_2` string — Second line of the recipient's address.
    - `recipient_city` string — City of the recipient's address.
    - `recipient_postal_code` string — Postal code of the recipient's address.
    - `recipient_state` string — State or province of the recipient's address.
    - `recipient_country_code` string — Country code of the recipient's address.
    - `recipient_tax_id` string — Tax identification number of the recipient.
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/1a6bffb20f7d?raw)