Documentation
IntroCreateBalanceHooksErrors

List Transactions

List your company's transactions, newest first, with pagination and filters.

GET/api/Transaction/company/transactions

Query Parameters (Optional)

page
integer

Page number (default: 1)

pageSize
integer

Items per page (default: 10, max: 200)

term
string

Free search: transactionId, endToEndId, customer name, email or document, payer name or document

enStatusTransaction
string

Status filter: awaiting, pending, successful (or paid), failure, refunded, chargeback

enPaymentSystem
string

Payment method filter: pix

startDate
string

Created on or after this date (ISO 8601, e.g. 2026-11-01)

endDate
string

Created on or before this date, inclusive (ISO 8601)

minValue
number

Minimum amount, in reais (10.50)

maxValue
number

Maximum amount, in reais

Results are always sorted by creation date, newest first.

Success Response (200 OK)

Response
{
  "items": [
    {
      "id": 1607997,
      "companyId": "1a6fc8db-c8ac-4964-a47e-8bd1716d26be",
      "transactionId": "cmw4q82zb0uzv6ooc55yifz8n",
      "value": 10.00,
      "installments": 1,
      "enStatusTransaction": "Successful",
      "enPaymentSystem": "Pix",
      "totalDeducted": 0.23,
      "providerEndToEndId": "E00000000202611060542abcdef12345",
      "providerPayerName": "JOAO SILVA",
      "providerPayerDocument": "12345678909",
      "providerCreditedAt": "2026-11-06T05:42:36.725",
      "lead": { "name": "Joao Silva", "email": "joao@email.com", "documentNumber": "12345678909" },
      "createdAt": "2026-11-06T02:41:10.118",
      "updateDate": "2026-11-06T05:42:36.725+00:00"
    }
  ],
  "totalCount": 1,
  "page": 1,
  "pageSize": 10,
  "pageCount": 1,
  "paidCount": 1,
  "paidAmount": 10.00
}
items[].transactionId
string

The id returned when the transaction was created

items[].value
number

Amount in reais (10.00 = R$ 10.00). Unlike the create endpoint, this is not in cents

items[].enStatusTransaction
string

Awaiting, Pending, Processing, Successful, Failure, Cancelled, Refunded, Chargeback

items[].totalDeducted
number

Total fees charged on this transaction, in reais

items[].providerEndToEndId
string | null

PIX end-to-end id, after payment

totalCount
integer

Total of transactions matching the filters

pageCount
integer

Number of pages for the current pageSize

paidCount / paidAmount
integer / number

Paid transactions matching the filters and their total in reais

JavaScript Example

JavaScript
const CLIENT_ID = 'e1c98954cc404cbcb2868af9b40c7a33';
const API_KEY = 'your-secret-api-key';
const query = {
  page: 1,
  pageSize: 50,
  enStatusTransaction: 'successful',
  startDate: '2026-11-01',
  endDate: '2026-11-06',
};
const queryString = new URLSearchParams(query).toString();
const response = await fetch(
  `https://baanko.app/api/Transaction/company/transactions?${queryString}`,
  {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'X-Client-Id': CLIENT_ID,
      'X-API-Key': API_KEY,
    },
  }
);
const data = await response.json();
console.log('Total:', data.totalCount, 'Pages:', data.pageCount);
data.items.forEach(t => console.log(t.transactionId, t.enStatusTransaction, t.value));

cURL Example

cURL
curl -X GET "https://baanko.app/api/Transaction/company/transactions?page=1&pageSize=50&enStatusTransaction=successful&startDate=2026-11-01" \
  -H "Accept: application/json" \
  -H "X-Client-Id: <CLIENT_ID>" \
  -H "X-API-Key: <API_KEY>"