---
title: "Retrieve a kyb transaction by reference"
method: GET
path: "/compliance/transaction/{reference}"
tags: ["Compliance"]
---

# Retrieve a kyb transaction by reference

`GET /compliance/transaction/{reference}`

## Path parameters

- `reference` string, required

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- KybTransactionDto
  - `id` number, required — The id identifying the transaction
  - `kyb` KybDto, required
    - `merchantId` string, required — The id identifying the merchant
    - `name` string, required — Name of the declared sub-merchant
    - `businessType` string, required — Type of business of the sub-merchant
    - `businessRegistrationId` string, required — Business registration id
    - `taxNumber` string, required — Tax number
    - `directorName` string, required — Director name
    - `websiteUrl` string, required — Website url of the company
    - `country` string, required — Country where the company is located
    - `headquarterAddress` string, required — Address of the headquarter of the company
    - `id` number, required — The id identifying the kyb
    - `createdAt` string, date-time, required — Datetime in UTC timezone at which this object was created. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
    - `deletedAt` object, required — Datetime in UTC timezone at which this object was deleted. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601). Can be null.
  - `reference` string, required — Reference of the transaction. Should be unique for a given merchantId
  - `amount` number, required — Amount of the transaction
  - `currency` string, required — Currency in which the transaction has been done
  - `createdAt` string, date-time, required — Datetime in UTC timezone at which this object was created. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
  - `status` 'created' | 'pending' | 'rejected' | 'validated', required — Enum indicating the status of the kyb transaction
  - `rejectionReason` string — The reason why a kyb transaction has been rejected by Hub2 teams (i.e, the deposit hasn't been done)
  - `iban` string, required — Iban of the bank account on which funds have been transferred

## Other responses

- `401` — Wrong credentials
- `404` — Not Found
- `500` — Internal error

---

[API](https://skmtc.net/hub2/apis/hub2-service-api.md) · [All operations](https://skmtc.net/hub2/apis/hub2-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hub2/hub2-service-api/versions/adb17b4b80f4/schema)