---
title: "Returns all transactions generated within the specified due date range"
method: GET
path: "/v2/transactions"
tags: ["Transactions"]
---

# Returns all transactions generated within the specified due date range

`GET /v2/transactions`

Returns all transactions generated within the specified due date range. The date range must not exceed 31 days

**Required Query Parameters:**
- page: The page number to return in the query
- limit: The number of items to return per page. Maximum of 100
- sort: The sort order of items by creation date. Allowed values: ASC (ascending) or DESC (descending)
- due_date_start: The start of the due date range for filtering transactions
- due_date_end: The end of the due date range for filtering transactions

**Optional Query Parameters:**
- include_payments: (Default is false) Returns a payments property for each transaction, showing all associated payment methods
- include_history: (Default is false) Returns the transaction’s notification history, along with responses (e.g., what the partner’s API responded when receiving notifications). Includes events such as settlements, receivables, and status changes
- include_summary: (Default is false) Includes a summary at the root of the response object, with a general total of items returned in the query, including those on other pages

**Include Summary:**
When include_summary is set to true, the response will include a summary with the following details:
- totalTransactions: Total number of transactions returned, counting across all pages
- totalAmount: Sum of the total transaction values across all pages (in the preferred currency)
- totalPaid: Total number of paid transactions
- totalPaidAmount: Total amount of the paid transactions
- totalPaidDate1: Total number of transactions paid by the best due date
- totalPaidAmountDate1: Total amount of transactions paid by the best due date
- totalUnpaid: Total number of unpaid transactions
- totalUnpaidAmount: Sum of the unpaid transaction amounts (best due date amount)
- totalUnpaidOverdueAmount: Sum of the unpaid and overdue transaction amounts (gross amount)
- totalCanceled: Total number of canceled transactions
- TotalCanceledAmount: Sum of the canceled transaction amounts
- totalSettled: Total number of settled transactions
- TotalSettledAmount: Sum of the settled transaction amounts
- totalVoided: Total number of voided transactions
- TotalVoidedAmount: Sum of the voided transaction amounts

## Query parameters

- `page` string, required
- `limit` string, required
- `sort` 'ASC' | 'DESC', required
- `due_date_start` string
- `due_date_end` string
- `include_payments` boolean
- `include_history` boolean
- `include_summary` boolean
- `reference_id` string
- `transaction_id` string

## Response `200`

The record has been successfully getted

- AllTransactionResponseV2
  - `created_at` string, required
  - `updated_at` string
  - `sandbox` boolean, required
  - `status` 'PAID' | 'CANCELED' | 'SETTLED' | 'VOIDED' | 'OPEN', required — Current transaction status
  - `paid_at` string, nullable — When the transaction was paid
  - `paid_with` 'PIX' | 'BANK_SLIP' | 'CREDIT_CARD' | 'DEBIT_CARD' | 'BANK_SLIP_PIX_WITH_PIX' | 'BANK_SLIP_PIX_WITH_BARCODE', nullable, required — Payment method with which the transaction was paid
  - `paid_amount` number
  - `transaction_id` string, required — Edubank transaction id
  - `reference_id` string, required
  - `seller_id` string, required — Edubank seller id
  - `allows` AllowsMethod, required
    - `pix` boolean, required
    - `bank_slip` boolean, required
    - `credit_card` boolean, required
  - `buyer` EdubankBuyers
    - `id` string — Buyer id
    - `first_name` string, required — Buyer's first name
    - `last_name` string, required — Buyer's last name
    - `email` string — Buyer's email
    - `taxpayer_id` string, required — Buyer's CPF/CNPJ
    - `birthdate` string — Buyer's date of birth
    - `phone_number` string — Buyer's phone number
    - `address` EdubankBuyersAddress, required
      - `city` string, required — City
      - `additional_information` string — Additional address data. In this field you can inform complement, references
      - `number` string, required — Number
      - `state_code` string, required — State (UF)
      - `street` string, required — Street / Patio
      - `neighborhood` string, required — Neighborhood
      - `zip` string, required — Postal Zone / ZIP Code)
      - `country_code` 'BR', required — Buyer's country code
  - `transaction_items` EdubankTransactionItems[], nullable — Edubank transaction items
    - `item` string, required — Item Description
    - `amount` string, required — Item amount
    - `reference` string — Item reference
    - `note` string — Item note
  - `transaction_details` EdubankTransactionDetails, required
    - `amount` number, required — Gross amount to be paid. Ex: 2010 = 20.10
    - `due_date` string, required — Due date
    - `payment_limit_date` string, required — Deadline for payment
    - `body_instructions` string[] — Up to five bank slip instructions
    - `late_fee` EdubankLateFee
      - `mode` string, required — Billing mode. Accepted values: FIXED (fixed) or PERCENTAGE (percentage)
      - `amount` string, required — Late fee amount. Ex: 2.00
    - `interest` EdubankInterest
      - `mode` string, required — Billing mode. Accepted values: DAILY_AMOUNT, DAILY_PERCENTAGE
      - `amount` string, required — Interest fee amount. Ex: 0.033
    - `discount` EdubankDiscount
      - `mode` string, required — Billing mode. Accepted values: FIXED (fixed) or PERCENTAGE (percentage)
      - `date_1` string, required — Deadline for payment to occur with discount 1. It must be before the date entered in "Due date"
      - `amount_1` number, required — Discount 1 amount. Ex: 2010 = 20.10
      - `date_2` string — Deadline for payment to occur with discount 2. It must be before the date entered in "date_1"
      - `amount_2` number — Discount 2 amount. Ex: 2010 = 20.10
      - `date_3` string — Deadline for payment to occur with discount 3. It must be before the date entered in "date_2"
      - `amount_3` number — Discount 3 amount. Ex: 2010 = 20.10
  - `split_rules` EdubankSplit[]
    - `recipient` string, required — Recipient seller_id
    - `amount` number — Value that will be split. Ex: 2010 = 20.10
    - `percentage` string, required — Split percentage
    - `processing_fee` string, required — Defines which seller should process fees. MAIN = Seller who created the transaction. RECIPIENT = Seller informed in the split.
  - `notification_url` string, required
  - `history` AllTransactionReponseV2History[], required
    - `event_id` string, required
    - `created_at` string, required
    - `sent_with_success` boolean, required
    - `sent_attempts` number, required
    - `sent_with_success_in` string, required
    - `partner_response` string[], required — Partner API Response

## Other responses

- `400` — Client specified an invalid argument, request body or query param
- `401` — The user is unauthorized
- `403` — Authenticated user is not allowed to access this resource
- `404` — The resource was not found
- `408` — Request timeout
- `422` — Error: Unprocessable Entity
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) · [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edubank/api-edubank/revisions/dce4008191d4/schema)