FAfactorialhr
Finance > FinancialDocument

Reads all Financial documents

Changed on

Fetch one or all financial documents for the company.

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/financial_documents
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Query parameters

company_idstring

Return only the documents of this company. It must be a company the reader has access to: an id outside that set makes the read fail rather than come back empty.

Example:1
ids[]string[]

Return only the financial documents with these ids.

[
  "135"
]
vendor_idstring

Return only the documents issued by this vendor contact.

Example:33
currencystring

Return only the documents in this currency, as an uppercase ISO 4217 code. It takes one code, not a list.

Example:USD
statuses[]string[]

Return only the documents in these states: processing, review (awaiting approval), sent_to_pay or paid.

[
  "review"
]
legal_entity_ids[]string[]

Return only the documents booked against these legal entities.

[
  "13"
]
document_types[]string[]

Return only the documents of these kinds: invoice, receipt or credit_note.

[
  "invoice"
]
updated_fromstring

Filter financial documents updated from a specific date

Example:2020-01-01

Response

OK

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"
    }
  ]
}

Changes