Get transfer details

GET /transfers/{transferId}

Retrieve detailed information about a specific transfer

Headers

  • Workspace-ID integer Required

    The workspace ID - to identify the sub-user

Path parameters

  • transferId integer Required

    Transfer ID

Responses

  • 200 application/json

    Transfer details

    Hide response attributes Show response attributes object
    • amount string Required

      Transfer amount (in smallest unit)

    • createdAt string

      Creation timestamp

    • description string

      Transfer description

    • direction string

      Transfer direction (debit/credit)

    • edges object
      Hide edges attributes Show edges attributes object
      • account object

        Bank account holding a specific currency with balance tracking

        Hide account attributes Show account attributes object
        • alias string

          Account nickname

        • code string

          Core Banking System account code

        • createdAt string

          Creation timestamp

        • edges object
          Hide edges attributes Show edges attributes object
          • balances array[object] Required

            Account balance snapshot at a point in time

            Hide balances attributes Show balances attributes object
            • amount integer Required

              Balance amount in smallest currency unit (e.g., cents)

            • createdAt string

              Creation timestamp

            • id integer Required

              Balance ID

            • updatedAt string

              Last update timestamp

          • currency object Required

            Currency information including symbol, code, and decimal places

            Hide currency attributes Show currency attributes object
            • code string Required

              ISO currency code (e.g., USD, EUR)

            • createdAt string

              Creation timestamp

            • decimals integer

              Number of decimal places

            • id integer Required

              Currency ID

            • name string Required

              Currency full name

            • swiftMinimumWithdrawalAmount string

              Minimum SWIFT withdrawal amount

            • symbol string

              Currency symbol (e.g., $, €)

            • updatedAt string

              Last update timestamp

          • product object Required

            Banking product (currency account type) available for creation

            Hide product attributes Show product attributes object
            • createdAt string

              Creation timestamp

            • description string

              Product description

            • edges object
              Hide edges attribute Show edges attribute object
              • currency object Required

                Currency information including symbol, code, and decimal places

                Hide currency attributes Show currency attributes object
                • code string Required

                  ISO currency code (e.g., USD, EUR)

                • createdAt string

                  Creation timestamp

                • decimals integer

                  Number of decimal places

                • id integer Required

                  Currency ID

                • name string Required

                  Currency full name

                • swiftMinimumWithdrawalAmount string

                  Minimum SWIFT withdrawal amount

                • symbol string

                  Currency symbol (e.g., $, €)

                • updatedAt string

                  Last update timestamp

            • id integer Required

              Product ID

            • name string Required

              Product name

            • updatedAt string

              Last update timestamp

        • id integer Required

          Account ID

        • name string Required

          Account holder name

        • status string Required

          Account status (enabled/disabled)

        • type string Required

          Account type (e.g., CACC)

        • updatedAt string

          Last update timestamp

      • balance object

        Account balance snapshot at a point in time

        Hide balance attributes Show balance attributes object
        • amount integer Required

          Balance amount in smallest currency unit (e.g., cents)

        • createdAt string

          Creation timestamp

        • id integer Required

          Balance ID

        • updatedAt string

          Last update timestamp

      • recipient object

        Transfer recipient with account details for domestic or international transfers

        Hide recipient attributes Show recipient attributes object
        • accountCode string Required

          Recipient account code

        • alias string

          Recipient nickname

        • createdAt string

          Creation timestamp

        • edges object
          Hide edges attributes Show edges attributes object
          • bank object

            Bank information including name and SWIFT code

            Hide bank attributes Show bank attributes object
            • countryCode string

              Bank country code (ISO 3166-1 alpha-2)

            • createdAt string

              Creation timestamp

            • id integer Required

              Bank ID

            • name string Required

              Bank name

            • swiftCode string

              Bank SWIFT/BIC code

            • updatedAt string

              Last update timestamp

          • beneficiary object

            Beneficiary information for international transfers

            Hide beneficiary attributes Show beneficiary attributes object
            • createdAt string

              Creation timestamp

            • data object
            • id integer Required

              Beneficiary ID

            • updatedAt string

              Last update timestamp

          • currency object

            Currency information including symbol, code, and decimal places

            Hide currency attributes Show currency attributes object
            • code string Required

              ISO currency code (e.g., USD, EUR)

            • createdAt string

              Creation timestamp

            • decimals integer

              Number of decimal places

            • id integer Required

              Currency ID

            • name string Required

              Currency full name

            • swiftMinimumWithdrawalAmount string

              Minimum SWIFT withdrawal amount

            • symbol string

              Currency symbol (e.g., $, €)

            • updatedAt string

              Last update timestamp

        • id integer Required

          Recipient ID

        • name string Required

          Recipient name

        • saved boolean

          Whether recipient is saved

        • updatedAt string

          Last update timestamp

      • transaction object

        Transaction represents the execution of a transfer with status tracking

        Hide transaction attributes Show transaction attributes object
        • createdAt string

          Creation timestamp

        • edges object
          Hide edges attributes Show edges attributes object
          • internationalRemittance object

            International money transfer details and tracking

            Hide internationalRemittance attributes Show internationalRemittance attributes object
            • createdAt string

              Creation timestamp

            • edges object
              Hide edges attribute Show edges attribute object
              • events array[object]

                International transaction event from payment provider

                Hide events attributes Show events attributes object
                • createdAt string

                  Creation timestamp

                • id integer Required

                  Event ID

                • lastUpdatedAt string

                  Last update timestamp

                • message string

                  Event message or status description

                • status string Required

                  Transaction status

            • id integer Required

              International remittance ID

            • updatedAt string

              Last update timestamp

          • transfers array[object]

            Executed transfer moving funds between accounts

            Executed transfer moving funds between accounts

        • hash string

          Transaction hash

        • id integer Required

          Transaction ID

        • status string Required

          Transaction status (pending/completed/failed)

        • updatedAt string

          Last update timestamp

    • feeAmount string

      Fee amount charged for the transfer

    • id integer Required

      Transfer ID

    • purpose string

      Transfer purpose

    • type string

      Transfer type (spot, etc.)

    • updatedAt string

      Last update timestamp

  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • errorCode string Required

      Error code

    • message string Required

      Error message

  • 404 application/json

    Transfer not found

    Hide response attributes Show response attributes object
    • errorCode string Required

      Error code

    • message string Required

      Error message

GET /transfers/{transferId}
curl \
 --request GET 'https://bank.bank.place/transfers/{transferId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Workspace-ID: 42"
Response examples (200)
{
  "amount": "string",
  "createdAt": "string",
  "description": "string",
  "direction": "string",
  "edges": {
    "account": {
      "alias": "string",
      "code": "string",
      "createdAt": "string",
      "edges": {
        "balances": [
          {
            "amount": 42,
            "createdAt": "string",
            "id": 42,
            "updatedAt": "string"
          }
        ],
        "currency": {
          "code": "string",
          "createdAt": "string",
          "decimals": 42,
          "id": 42,
          "name": "string",
          "swiftMinimumWithdrawalAmount": "string",
          "symbol": "string",
          "updatedAt": "string"
        },
        "product": {
          "createdAt": "string",
          "description": "string",
          "edges": {
            "currency": {
              "code": "string",
              "createdAt": "string",
              "decimals": 42,
              "id": 42,
              "name": "string",
              "swiftMinimumWithdrawalAmount": "string",
              "symbol": "string",
              "updatedAt": "string"
            }
          },
          "id": 42,
          "name": "string",
          "updatedAt": "string"
        }
      },
      "id": 42,
      "name": "string",
      "status": "string",
      "type": "string",
      "updatedAt": "string"
    },
    "balance": {
      "amount": 42,
      "createdAt": "string",
      "id": 42,
      "updatedAt": "string"
    },
    "recipient": {
      "accountCode": "string",
      "alias": "string",
      "createdAt": "string",
      "edges": {
        "bank": {
          "countryCode": "string",
          "createdAt": "string",
          "id": 42,
          "name": "string",
          "swiftCode": "string",
          "updatedAt": "string"
        },
        "beneficiary": {
          "createdAt": "string",
          "data": {},
          "id": 42,
          "updatedAt": "string"
        },
        "currency": {
          "code": "string",
          "createdAt": "string",
          "decimals": 42,
          "id": 42,
          "name": "string",
          "swiftMinimumWithdrawalAmount": "string",
          "symbol": "string",
          "updatedAt": "string"
        }
      },
      "id": 42,
      "name": "string",
      "saved": true,
      "updatedAt": "string"
    },
    "transaction": {
      "createdAt": "string",
      "edges": {
        "internationalRemittance": {
          "createdAt": "string",
          "edges": {
            "events": [
              {
                "createdAt": "string",
                "id": 42,
                "lastUpdatedAt": "string",
                "message": "string",
                "status": "string"
              }
            ]
          },
          "id": 42,
          "updatedAt": "string"
        },
        "transfers": [
          {}
        ]
      },
      "hash": "string",
      "id": 42,
      "status": "string",
      "updatedAt": "string"
    }
  },
  "feeAmount": "string",
  "id": 42,
  "purpose": "string",
  "type": "string",
  "updatedAt": "string"
}
Response examples (401)
{
  "message": "Invalid request parameters",
  "errorCode": "invalid_request"
}
Response examples (404)
{
  "message": "Invalid request parameters",
  "errorCode": "invalid_request"
}