List payments by sub-tenant
Returns a paginated, filterable list of automatic payment legs for a single sub-tenant. Pair with List payments by tenant when you need a tenant-wide view.
/api/v1/automatic-payments/payments/sub-tenants/{subTenantId}Get payments by sub-tenant
Lists automatic payments for one sub-tenant with optional filters.
Parâmetros de path
1 camposubTenantId●Sub-tenant identifier.
Parâmetros de query
11 camposstartDateInterval start (ISO 8601).
endDateInterval end (ISO 8601).
minLastUpdateDateMinimum last update timestamp.
maxLastUpdateDateMaximum last update timestamp.
status`PENDENTE`, `EM_PROCESSAMENTO`, `PAGO`, `REJEITADO`, or `CANCELADO`.
consentStatusConsent status filter (OpenAPI: array; comma-separated or repeated per gateway rules).
aggregatePaymentsWhen `true`, include `retriedPayments` for linked attempts. Defaults to `true` if omitted.
debtorDocumentDebtor CPF/CNPJ filter.
creditorDocumentCreditor CPF/CNPJ filter.
rejectionReasonRejection reason filter.
termGeneric search term.
curl --request GET \
--url 'https://embedded-payment-manager.hml.linaob.com.br/api/v1/automatic-payments/payments/sub-tenants/subtenant_abc123?startDate=2026-01-01T00%3A00%3A00Z&endDate=2026-12-31T23%3A59%3A59Z&minLastUpdateDate=2026-05-01T00%3A00%3A00Z&maxLastUpdateDate=2026-05-31T23%3A59%3A59Z&status=EM_PROCESSAMENTO&consentStatus=%5B%22AUTHORISED%22%5D&aggregatePayments=true&debtorDocument=76109277673&creditorDocument=12345678000195&rejectionReason=INSUFFICIENT_FUNDS&term=invoice' \
--header 'Authorization: Bearer <SEU_TOKEN>'Response
- dataarray of objectsrequired
AutomaticPayment entries.
- itemobject
- messagestring
Response message.
- typestring
Envelope type.
- metaobjectrequired
Pagination metadata.
{
"data": [
{
"id": "pay_002",
"status": "PENDENTE"
}
],
"message": "",
"type": "success",
"meta": {
"pageIndex": 0,
"pageSize": 10,
"total": 1
}
}Next steps
- Create recurring payment — create a new leg under an authorised consent.
- Update recurring payment — cancel or adjust a leg when rules allow.