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

# Transaction:Find

`GET /transactions/find`

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` — Resource 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.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)