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

# Transaction:Find

`GET /transactions/find`

## Request

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

Find a transaction based on the provided search criteria

## Query parameters

- `needle` object
  - `eq` string: Get results that equal the given value

## Response `200`

Ok.

- object
  - `total` integer
  - `count` 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)