---
title: "Search Transactions by Period"
method: GET
path: "/v3/transactions"
tags: ["Search API"]
---

# Search Transactions by Period

`GET /v3/transactions`

Retrieves a list of transactions processed by PagSeguro within the specified date range. 
This endpoint allows merchants to filter transactions based on their creation date and supports pagination.

## Query parameters

- `initial_transaction_date` string, date-time, required
- `final_transaction_date` string, date-time, required
- `page` integer
- `max_results` integer

## Response `200`

Transactions retrieved successfully.

- object
  - `transactions` object[] — List of transactions matching the search criteria.
    - `code` string — Unique transaction identifier (UUID) assigned by PagSeguro.
    - `status` string — Current status of the transaction.
    - `refundable` boolean — Indicates whether the transaction is eligible for a refund.
    - `integration` object — Details related to the merchant's store and order reference.
      - `reference` string — Unique order reference assigned by the merchant.
      - `store` integer — Identifier of the merchant's store.
      - `project` integer — Project ID provided by the merchant during integration.
      - `notification_url` string — URL where PagSeguro sends transaction status updates.
    - `charge` object — Information about the payment method used for the transaction.
      - `country` string — Country where the payer is located.
      - `type` string — Payment type used by the payer.
      - `method` string — Specific payment method used for the transaction.
      - `credit_card` object
        - `installments` integer — Number of installments selected by the payer.
        - `bin` string — The first 6 digits of the credit card number.
        - `last_four` string — The last 4 digits of the credit card number.
        - `expiration_date` string — Credit card expiration date in YYYY-MM format.
        - `card_on_file` object
          - `id` string — The ID of the stored card.
      - `initiated_by` string — Indicates who initiated the transaction.
      - `recurrence` object
        - `id` string — The recurrence ID.
        - `type` string — The type of recurrence.
        - `scheduling` string — The scheduling type for the recurrence (e.g., INITIAL, SUBSEQUENT).
      - `payment_response` object — Contains details of a failed payment attempt due to issues with card processing. This object is only returned for certain transactions. Contact your Account Manager for more details.
        - `code` integer — Error code indicating the reason for transaction failure.
        - `message` string — Description of the error or failure reason.
    - `checkout` object — Details of the checkout process.
      - `language` string — Language used at the checkout by the payer.
    - `payer` object — Information about the customer who made the purchase.
      - `email` string — Payer's email address.
    - `order` object — Details of the order associated with the transaction.
      - `date` string, date-time — Date and time when the transaction was created (UTC format).
      - `currency` string — Currency in which the order was processed (ISO 4217 code).
      - `items` object[] — List of products or services included in the transaction.
        - `quantity` integer — Number of units purchased for this item.
        - `description` string — Description of the item.
        - `unit_price` number, float — Price per unit of the item.
    - `payment` object
      - `type` string — The type of payment.
      - `method` string — The payment method used.
    - `refunds` object[] — List of refunds associated with the transaction.
      - `id` integer — Unique identifier of the refund request.
      - `reference` string — Refund reference assigned by the merchant.
      - `status` string — Current status of the refund request. Possible values: - `REQUESTED`: Refund has been requested. - `PROCESSING`: Refund is being processed. - `PROCESSED`: Refund has been successfully completed. - `REJECTED`: Refund request was denied.
      - `amount` number, float — Amount requested for the refund.
      - `date` string, date-time — Date and time when the refund request was created (UTC format).
      - `processing_date` string, date-time — Date and time when the refund was processed (UTC format).
  - `pagination` object — Pagination details for the search results.
    - `total` integer — Total number of transactions matching the search criteria.
    - `results` integer — Number of results per page.
    - `page` integer — Current page number.
    - `pages` integer — Total number of pages available.

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data.
- `401` — Unauthorized - Authentication failed due to missing or invalid credentials.

---

[API](https://skmtc.net/pagseguro/apis/pagseguro-international-api.md) · [All operations](https://skmtc.net/pagseguro/apis/pagseguro-international-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagseguro/pagseguro-international-api/revisions/032af0550731/schema)