List payments

curl --request GET \
  --url https://payments.sandbox.lerian.net/v1/payments \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://payments.sandbox.lerian.net/v1/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://payments.sandbox.lerian.net/v1/payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "amount": "<string>",
      "createdAt": "<string>",
      "id": "<string>",
      "ledgerId": "<string>",
      "midazAccountId": "<string>",
      "organizationId": "<string>",
      "status": "<string>",
      "type": "<string>",
      "updatedAt": "<string>",
      "canceledAt": "<string>",
      "cancellationReason": "<string>",
      "darf": {
        "fineAmount": "<string>",
        "interestAmount": "<string>",
        "mainAmount": "<string>",
        "name": "<string>",
        "personType": "<string>",
        "referenceDate": "<string>",
        "taxId": "<string>",
        "treasuryRevenueCode": "<string>",
        "type": "<string>"
      },
      "description": "<string>",
      "digitableLine": "<string>",
      "dueDate": "<string>",
      "errorMessage": "<string>",
      "failedAt": "<string>",
      "failureCode": "PBP-0211",
      "midazOperationId": "<string>",
      "payee": {
        "name": "<string>",
        "taxId": "<string>"
      },
      "providerId": "<string>",
      "providerRequestId": "<string>",
      "rejectedAt": "<string>",
      "rejectionReason": "<string>",
      "settledAmount": "<string>",
      "settledAt": "<string>"
    }
  ],
  "limit": 123,
  "page": 123,
  "total": 123
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

GET

payments

List payments

curl --request GET \
  --url https://payments.sandbox.lerian.net/v1/payments \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://payments.sandbox.lerian.net/v1/payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://payments.sandbox.lerian.net/v1/payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "amount": "<string>",
      "createdAt": "<string>",
      "id": "<string>",
      "ledgerId": "<string>",
      "midazAccountId": "<string>",
      "organizationId": "<string>",
      "status": "<string>",
      "type": "<string>",
      "updatedAt": "<string>",
      "canceledAt": "<string>",
      "cancellationReason": "<string>",
      "darf": {
        "fineAmount": "<string>",
        "interestAmount": "<string>",
        "mainAmount": "<string>",
        "name": "<string>",
        "personType": "<string>",
        "referenceDate": "<string>",
        "taxId": "<string>",
        "treasuryRevenueCode": "<string>",
        "type": "<string>"
      },
      "description": "<string>",
      "digitableLine": "<string>",
      "dueDate": "<string>",
      "errorMessage": "<string>",
      "failedAt": "<string>",
      "failureCode": "PBP-0211",
      "midazOperationId": "<string>",
      "payee": {
        "name": "<string>",
        "taxId": "<string>"
      },
      "providerId": "<string>",
      "providerRequestId": "<string>",
      "rejectedAt": "<string>",
      "rejectionReason": "<string>",
      "settledAmount": "<string>",
      "settledAt": "<string>"
    }
  ],
  "limit": 123,
  "page": 123,
  "total": 123
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

X-Organization-Id

string

Midaz organization whose payments are listed. Required: a request without it, or with a value that is not a canonical UUID, is refused with 400 PBP-0025. Only payments of this organization are listed and counted.

Query Parameters

status

enum<string>

Status filter. UNCONFIRMED selects the payments whose outcome at the payment provider is not known yet: an initiation answered 202 leaves its payment there until it resolves.

Available options:

UNCONFIRMED,

CREATED,

SCHEDULED,

PENDING_APPROVAL,

APPROVED,

EXECUTED,

SETTLED,

REJECTED,

FAILED,

CANCELED

Example:

"CREATED"

type

enum<string>

Payment type filter.

Available options:

BANKSLIP,

UTILITIES,

DARF

Example:

"BANKSLIP"

from

string

Created-from bound, inclusive. A calendar date (YYYY-MM-DD) is a UTC day and starts at its first instant; an RFC 3339 date-time with offset (e.g. 2026-09-30T00:00:00-03:00) is used as the exact instant. A positive offset must be percent-encoded (%2B).

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2}))?$

Example:

"2026-01-01"

string

Created-to bound, inclusive. A calendar date (YYYY-MM-DD) is a UTC day and covers it to its last instant; an RFC 3339 date-time with offset (e.g. 2026-09-30T23:59:59.999999-03:00) is used as the exact instant. A positive offset must be percent-encoded (%2B).

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2}))?$

Example:

"2026-12-31"

dueDateFrom

string<date>

Due-date lower bound, inclusive. It matches the DARF and BANKSLIP payments that carry a due date (see dueDate on the payment). UTILITIES payments carry none, so this bound matches none of them.

Example:

"2026-02-01"

dueDateTo

string<date>

Due-date upper bound, inclusive. It matches the DARF and BANKSLIP payments that carry a due date (see dueDate on the payment). UTILITIES payments carry none, so this bound matches none of them.

Example:

"2026-11-30"

page

integer<int64>

default:1

Page number, one-based.

Required range: x >= 1

Example:

1

limit

integer<int64>

default:20

Items per page.

Required range: 1 <= x <= 100

Example:

20

idempotencyKey

string

The Idempotency-Key a payment was created under, on POST /v1/payments or POST /v1/payments/darf. Lists the payment that key created in this organization, if any: the way to find what a creation answered without a payment id left behind, a 5xx above all. A key whose creation was refused before anything was created lists nothing. A payment retried under the same key after a refusal for funds is listed with the refused attempt. Combines with the other filters. A value that is not a UUID is refused with 400 PBP-0001; an empty value is ignored, as on the other filters. Meant for recovering one request, not for polling.

Example:

"6f9619ff-8b86-d011-b42d-00c04fc964ff"

Response

items

object[] | null

required

Show child attributes

limit

integer<int64>

required

page

integer<int64>

required

total

integer<int64>

required

Boletos API

Payments API

Dashboards API

Admin API

Webhooks API

Error handling

List payments

Authorizations

Headers

Query Parameters

Response