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": {
        "accountDigit": "7",
        "accountId": "acc-123",
        "accountNumber": "123456",
        "accountType": 0,
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      },
      "payer": {
        "accountDigit": "7",
        "accountId": "acc-123",
        "accountNumber": "123456",
        "accountType": 0,
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      }
    }
  ]
}

{
  "code": "ERR-0001",
  "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": "ERR-0001",
  "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": "ERR-0001",
  "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 CRM account id), 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. There is no filter on the institution — for one of them, account_id is its @pi_{ispb} settlement alias rather than a CRM account id, which is the practical way to isolate it here, and GET /v1/indirects//transactions is the purpose-built feed (it is windowed, cursor-paged and ordered for reconciliation, which this one is not).

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": {
        "accountDigit": "7",
        "accountId": "acc-123",
        "accountNumber": "123456",
        "accountType": 0,
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      },
      "payer": {
        "accountDigit": "7",
        "accountId": "acc-123",
        "accountNumber": "123456",
        "accountType": 0,
        "branch": "0001",
        "document": "12345678909",
        "ispb": "12345678",
        "key": "foo@bar.com",
        "keyType": 2,
        "name": "Jane Doe"
      }
    }
  ]
}

{
  "code": "ERR-0001",
  "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": "ERR-0001",
  "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": "ERR-0001",
  "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 CRM account id.

Example:

"acc-123"

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"

Response

data

object[] | null

required

The list of transactions.

Show child attributes

Key DICT API

Key Claims API

Banks API

Indirect participants API

Transactions API

Transaction Limits API

QR Codes API

Refunds API

Pix Automático · Authorization requests

Pix Automático · Authorization management

Pix Automático · Composite QR codes

Pix Automático · Authorization events

Pix Automático · Schedule events

Pix Automático · Schedules and payment instructions

Pix Automático · Settlement

MED · Refunds

MED · Fraud markers

MED · Infractions

MED · Value recovery

Webhooks API

Error handling

Events

List PIX transactions

Authorizations

Query Parameters

Response