---
title: "Transaction:Browse"
method: GET
path: "/transactions"
tags: ["Transactions"]
---

# Transaction:Browse

`GET /transactions`

## Request

- Base URL: `https://rest.pay.nl/v2`
- URL: `https://rest.pay.nl/v2/transactions`
- Auth: HTTP basic

Retrieve the transactions for a merchant up to 10.000 transaction limited to 100 trx per page and maximum 100 pages.

## Query parameters

- `limit` integer
- `page` integer
- `id` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `in` string: Get results that correspond to one of the provided values.
  - `nin` string: Get results that do not correspond to one of the provided values.
- `amount` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `gt` integer: Get results that are greater than the given value
  - `gte` integer: Get results that are greater than or equal to the given value
  - `lt` integer: Get results that are less than the given value
  - `lte` integer: Get results that are less than or equal to the given value
- `amountRefunded` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `gt` integer: Get results that are greater than the given value
  - `gte` integer: Get results that are greater than or equal to the given value
  - `lt` integer: Get results that are less than the given value
  - `lte` integer: Get results that are less than or equal to the given value
- `date` object
  - `eq` string, date: Get results that equal the given value. Supported format is Y-m-d.
  - `neq` string, date: Get results that do not equal the given value. Supported format is Y-m-d.
  - `gt` string, date: Get results that are greater than the given value. Supported formats are Y-m-d or Y-m-d H:i:s
  - `gte` string, date: Get results that are greater than or equal to the given value. Supported formats are Y-m-d or Y-m-d H:i:s
  - `lt` string, date: Get results that are less than the given value. Supported formats are Y-m-d or Y-m-d H:i:s
  - `lte` string, date: Get results that are less than or equal to the given value. Supported formats are Y-m-d or Y-m-d H:i:s
- `orderId` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `description` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `status` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `in` integer: Get results that correspond to one of the provided values.
  - `nin` integer: Get results that do not correspond to one of the provided values.
- `extra1` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `extra2` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `extra3` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `object` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `reference` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `customer-email` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `accountnumber` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `customer-name` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `ip-address` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `like` string: Get results that are similar to the given value
  - `nlike` string: Get results that are not similar to the given value
- `country` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `in` string: Get results that correspond to one of the provided values.
  - `nin` string: Get results that do not correspond to one of the provided values.
- `paymentMethod` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `in` integer: Get results that correspond to one of the provided values.
  - `nin` integer: Get results that do not correspond to one of the provided values.
- `paymentMethodBrand` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `in` integer: Get results that correspond to one of the provided values.
  - `nin` integer: Get results that do not correspond to one of the provided values.
- `paymentMethodGroup` object
  - `eq` integer: Get results that equal the given value
  - `neq` integer: Get results that do not equal the given value
  - `in` integer: Get results that correspond to one of the provided values.
  - `nin` integer: Get results that do not correspond to one of the provided values.
- `service` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `in` string: Get results that correspond to one of the provided values.
  - `nin` string: Get results that do not correspond to one of the provided values.
- `merchant` object
  - `eq` string: Get results that equal the given value
  - `neq` string: Get results that do not equal the given value
  - `in` string: Get results that correspond to one of the provided values.
  - `nin` string: Get results that do not correspond to one of the provided values.
- `testMode` object
  - `eq` boolean: Get results that equal the given value
  - `neq` boolean: Get results that do not equal the given value

## Response `200`

Ok.

- object
  - `total` integer
  - `count` integer
  - `pages` integer
  - `transactions` TransactionFind[]
    - `id` Id (unresolved $ref)
    - `orderId` OrderId (unresolved $ref)
    - `description` Description (unresolved $ref)
    - `reference` Reference (unresolved $ref)
    - `amount` Amount (unresolved $ref)
    - `amountRefunded` Amount (unresolved $ref)
    - `service` object
      - `code` string: The service code for which the transaction was started.
      - `name` string: The name of the service for which the transaction was started.
    - `paymentData` object
      - `customerId` CustomerId (unresolved $ref)
      - `customerKey` CustomerKey (unresolved $ref)
      - `customerName` CustomerName (unresolved $ref)
      - `ipAddress` IpAddress (unresolved $ref)
      - `secureStatus` SecureStatus (unresolved $ref)
    - `status` Status
      - `code` integer: The status code.
      - `action` string: The state in which the transaction resides
      - `phase` string: The current phase in the transaction state
    - `paymentMethodBrand` PaymentMethodBrand
      - `id` integer: The identifier of the payment profile brand.
      - `name` string: The name of the payment profile brand.
    - `paymentMethod` TransactionStatusPaymentMethod
      - `id` integer: The ID of the payment option e.g. iDEAL is 10. See: services/get/sl-xxxx-xxx.
      - `subId` integer: The chosen sub ID of the payment option e.g. The bank id for iDEAL. See: services/get/sl-xxxx-xxx.
    - `integration` Integration
      - `testMode` boolean: Indicates if the service is in testmode or not, possible values: false or true
    - `customer` object
      - `reference` Reference (unresolved $ref)
      - `firstName` FirstName (unresolved $ref)
      - `lastName` LastName (unresolved $ref)
      - `email` Email (unresolved $ref)
    - `orderDeliveryCountryCode` string: The code for the country the order will/has been delivered to.
    - `createdAt` CreatedAt (unresolved $ref)
    - `createdBy` CreatedBy (unresolved $ref)
    - `completedAt` string: The date at which the transaction was fully completed.
    - `expiredAt` string, date-time, nullable: Expire date in the correct ISO-8601 (a.k.a. ATOM) notation.

## Other responses

- `400`: Bad request, see response body for more information
- `401`: Unauthorized. Supplied credentials are invalid
- `403`: Forbidden. Supplied credentials have no rights
- `404`: Not found
- `405`: Used HTTP method is not allowed
- `406`: Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `429`: Rate limit reached.
- `500`: An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s.md) - [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api-s/revisions/6cd443c3aa96?raw)
