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.

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
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json