List supplier invoices linked to a landlord

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_id with GET /api/v1/profiles/{supplier_id} to retrieve the supplier name.
  • Resolve transaction_configuration_id with
    GET /api/v1/transaction_configurations/{transaction_configuration_id} to retrieve its
    human-readable name and invoice_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 method
  • supplier_id: filter by supplier public_id (or internal id)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Landlord profile public identifier (e.g. p_abc123)

Query Params
string

Filter by invoice status (pending, validated, to_pay, paid, dispute, archived)

string

Filter by payment method (landlord_debit, landlord_withholding_payment, landlord_direct_payment, tenant_billing_line)

string

Filter by supplier public_id (or internal id)

integer

Page number for pagination (default: 1)

integer

Number of items per page (default: 10, max: 100)

Responses

404

Landlord not found

Language
Credentials
Bearer
pk_...:sk_...
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json