Get Beneficiary Transaction by ID

Get specific beneficiary transaction details using its unique identifier.

Endpoint

GET /trp/beneficiary-transactions/{id}

Headers

Header	Type	Required	Description
x-api-key	string	Yes	Your API key for authentication
x-secret-key	string	Yes	Your secret key for authentication

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Unique beneficiary transaction identifier

Example Request

curl -X GET "{{baseUrl}}/trp/beneficiary-transactions/a673c894-e2be-4925-8cef-e71e29df5d6f" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Response

Success (200 OK)

{
  "success": true,
  "data": {
    "id": "a673c894-e2be-4925-8cef-e71e29df5d6f",
    "parent_transaction_id": "460286fb-2707-4037-a208-8a9878300f3e",
    "status": "Pending KYC on Originator Info",
    "amount": "5",
    "currency": "ETH",
    "created_at": "2025-08-25T04:37:45.820Z",
    "updated_at": "2025-08-25T04:37:45.820Z",
    "originator": {
      "kycCheck": {
        "error": "getaddrinfo ENOTFOUND sanctions.trpscout.co",
        "riskLevel": "ERROR",
        "hasMatches": false,
        "performedAt": "2025-08-25T04:37:45.816Z",
        "totalMatches": 0
      },
      "typeOfPerson": "natural",
      "originatorVASP": "SecureWallet Inc",
      "originatorLastName": "nook",
      "originatorFirstName": "Tom",
      "originatorWalletAddress": "0xb9dF910bF7E2451Ad3d5a51F89d6E1d17F47674C"
    },
    "beneficiary": {
      "kycCheck": {
        "matches": [
          {
            "id": "us-fed-excl-don-john-hayes-71350-mansura",
            "match": false,
            "score": 0.6577777777777778,
            "schema": "Person",
            "target": true,
            "caption": "DON JOHN HAYES",
            "datasets": [
              "us_sam_exclusions",
              "us_hhs_exclusions"
            ],
            "features": {
              "person_name_jaro_winkler": 0.8222222222222222,
              "person_name_phonetic_match": 0.5
            },
            "last_seen": "2025-07-23T09:03:36",
            "first_seen": "2024-05-08T21:57:02",
            "properties": {
              "name": [
                "DON JOHN HAYES"
              ],
              "topics": [
                "debarment"
              ],
              "address": [
                "6714 NOTHOFER STREET, MANSURA, LA 71350",
                "MANSURA, LA 71350, USA"
              ],
              "country": [
                "us"
              ],
              "lastName": [
                "HAYES"
              ],
              "position": [
                "HEALTH CARE AIDE (INTER CARE FACILITY)"
              ],
              "birthDate": [
                "1958-08-02"
              ],
              "createdAt": [
                "2002-07-26"
              ],
              "firstName": [
                "DON"
              ],
              "middleName": [
                "JOHN"
              ]
            },
            "last_change": "2024-10-11T13:01:00"
          }
        ],
        "topMatch": {
          "id": "us-fed-excl-don-john-hayes-71350-mansura",
          "match": false,
          "score": 0.6577777777777778,
          "schema": "Person",
          "target": true,
          "caption": "DON JOHN HAYES"
        },
        "queryInfo": {
          "schema": "Person",
          "entityType": "Natural Person",
          "propertiesUsed": [
            "name"
          ]
        },
        "riskLevel": "MEDIUM",
        "hasMatches": true,
        "performedAt": "2025-08-25T04:32:43.467Z",
        "highestScore": 0.6577777777777778,
        "totalMatches": 5
      },
      "typeOfPerson": "natural",
      "beneficiaryVaspId": "c8f61f62-1a20-41e9-9ac3-0ffb59bcf00e",
      "beneficiaryVaspUrl": "https://securewallet.com",
      "beneficiaryLastName": "Doe",
      "beneficiaryVaspName": "SecureWallet Inc",
      "beneficiaryFirstName": "John",
      "beneficiaryWalletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97"
    }
  }
}