List PIX transactions

curl --request GET \
  --url https://api.example.com/v1/transactions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/transactions"

	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://api.example.com/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "amount": 10050,
      "createdAt": "2026-06-19T12:00:00Z",
      "flow": 2,
      "id": "d1f9c0a2-...",
      "isRefund": false,
      "priority": 1,
      "status": "EXECUTED",
      "type": 1,
      "updatedAt": "2026-06-19T12:00:00Z",
      "description": "Invoice 42",
      "endToEndId": "E1234567890",
      "jdpiRequestId": "REQ-123",
      "payee": {
        "personType": 0,
        "accountDigit": "7",
        "accountId": "@pagador",
        "accountNumber": "123456",
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      },
      "payer": {
        "personType": 0,
        "accountDigit": "7",
        "accountId": "@pagador",
        "accountNumber": "123456",
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      }
    }
  ]
}

{
  "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>",
  "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>",
  "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"
  }
}

List PIX transactions

Lists the transactions this plugin has persisted, most recent first. Use it to reconcile your own records against the plugin’s, or to find the local transaction id of an order you know only by its end-to-end id.

Read-only. Every filter is optional and they combine with AND: account_id (the Midaz alias the row carries: the payer’s ledger account on a payment, the credited one on a cash-in, the debited one on a refund), end_to_end_id, status (the eTransactionStatus NAME, e.g. EXECUTED), and is_refund. is_refund is tri-state and parsed leniently — only “true” and “false” filter, and ANY other value (including “1” or “yes”) leaves the filter unset rather than erroring, so a typo there silently widens the result set. There is no pagination and no page size: the response is the whole matching set in one array, so filter narrowly on a busy account. Amounts are integer centavos.

An unknown account_id or end_to_end_id is not an error — it matches nothing and returns an empty array, so absence here means “nothing persisted under that value”, never “the value is wrong”. The only refusal is 400 PIX-0061 for a status that is not a known eTransactionStatus name.

THIS FEED INCLUDES MOVEMENTS THAT BELONG TO INDIRECT PARTICIPANTS, and nothing here separates them. When this participant serves indirect participants (institutions registered with POST /v1/indirects), their credits and payments are persisted as ordinary transactions and come back mixed in with the direct participant’s own. Name the institution to separate them: indirectId lists only one indirect’s transactions, and ispb only one direct participant’s books (its indirects included). GET /v1/indirects//transactions remains the purpose-built feed for reconciling an indirect (it is windowed, cursor-paged and ordered for reconciliation, which this one is not).

A token confined to one participant or one indirect has to name it in ispb or indirectId; the listing then holds only what that one holds, and naming another is refused before anything is read. Naming neither lists every participant’s transactions, exactly as before. Refusals: 422 PIX-0128 for an ispb this deployment does not act as; 400 for an indirectId that is not a UUID or an ispb that is not 8 digits.

GET

transactions

List PIX transactions

curl --request GET \
  --url https://api.example.com/v1/transactions \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://api.example.com/v1/transactions"

	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://api.example.com/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "amount": 10050,
      "createdAt": "2026-06-19T12:00:00Z",
      "flow": 2,
      "id": "d1f9c0a2-...",
      "isRefund": false,
      "priority": 1,
      "status": "EXECUTED",
      "type": 1,
      "updatedAt": "2026-06-19T12:00:00Z",
      "description": "Invoice 42",
      "endToEndId": "E1234567890",
      "jdpiRequestId": "REQ-123",
      "payee": {
        "personType": 0,
        "accountDigit": "7",
        "accountId": "@pagador",
        "accountNumber": "123456",
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      },
      "payer": {
        "personType": 0,
        "accountDigit": "7",
        "accountId": "@pagador",
        "accountNumber": "123456",
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      }
    }
  ]
}

{
  "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>",
  "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>",
  "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"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Query Parameters

account_id

string

Filter by the Midaz alias the row carries (the debited account on a refund, @pi_{ispb} for an indirect).

Example:

"@pagador"

end_to_end_id

string

Filter by the SPI end-to-end id.

Example:

"E1234567890"

status

string

Filter by eTransactionStatus name.

Example:

"EXECUTED"

is_refund

string

Filter by refund flag ('true'/'false').

Example:

"false"

ispb

string

The ISPB of the direct participant whose transactions are listed. OPTIONAL: omit it and the listing is not narrowed by participant, exactly as before. Named, only transactions booked in that participant's books come back - which includes those of the indirect participants it serves. An ISPB this deployment does not act as is 422 PIX-0128. It is ROUTING DATA you supply: it narrows what comes back and never widens what your token can reach, and a token confined to one participant has to name it here. Sending it empty (ispb=) reads the same as omitting it.

Pattern: ^[0-9]{8}$

Example:

"12345678"

indirectId

string<uuid>

The registered indirect participant (UUID) whose transactions are listed. OPTIONAL: omit it and the listing is not narrowed by indirect. Named, only transactions recorded for that indirect come back - never the direct participant's own. A token confined to one indirect has to name it here.

Example:

"3f2504e0-4f89-41d3-9a0c-0305e82c3301"

Response

data

object[] | null

required

The list of transactions.

Show child attributes

Direct participant APIs

Indirect participant APIs

List PIX transactions

Authorizations

Query Parameters

Response