Returns a paginated list of supplier invoices linked to the given landlord.
Overview
An invoice can be attached to a landlord through three different paths
(cf. Invoice#management_contract):
- directly via
asset_id(asset belonging to one of the landlord's management contracts), - via
asset_group_id(asset group attached to a management contract, either directly
or via its assets), - via
leasing_contract_id(leasing contract whose asset belongs to a management contract).
This endpoint covers the three paths so that callers do not have to query
/profiles/:id/assets and iterate /invoices?asset_id=... to build the same view.
Human-readable supplier and nature
The response exposes references rather than embedded labels:
- Resolve
supplier_idwithGET /api/v1/profiles/{supplier_id}to retrieve the supplier name. - Resolve
transaction_configuration_idwith
GET /api/v1/transaction_configurations/{transaction_configuration_id}to retrieve its
human-readablenameandinvoice_nature.
The public API does not currently expose an invoice's linked incident or intervention. An exact
intervention label therefore cannot be reconstructed from this endpoint alone.
Status semantics
Only invoices in status to_pay actually decrement the landlord's cash_balance_in_cents.
Invoices in status pending or validated are recorded but not yet impacting the balance.
Filter on status=to_pay to list only invoices that affect upcoming landlord payouts.
Filtering
status: filter by invoice status (pending, validated, to_pay, paid, dispute, archived)payment_method: filter by payment methodsupplier_id: filter by supplier public_id (or internal id)
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
404Landlord not found
