Transaction History by ID API Documentation

This document explains how to retrieve the details and status of a specific transaction using your own internal identifier (client_transaction_id).

Overview

The transaction/history/clientTransactionId/:id endpoint allows you to fetch the full details of a transaction by referencing the unique identifier you provided during transaction initiation. This is particularly useful for tracking the status of specific transactions without needing to store Swiftramp’s internal IDs.

Retrieve Transaction by ID

Description: Fetches detailed information for a single transaction record based on the provided client_transaction_id.

Path Parameters

Parameter	Type	Mandatory	Description
`id`	`string`	Yes	Your unique internal identifier for the transaction (the `client_transaction_id`).

cURL Command

curl --request GET \
  --url 'https://api.swiftramp.in/v1/transaction/history/clientTransactionId/[CLIENT_TRANSACTION_ID]' \
  --header 'Authorization: Bearer [ACCESS_TOKEN]' \
  --header 'Content-Type: application/json'

Success Response (200 OK)

{
    "status": true,
    "code": 200,
    "message": "Transaction fetched successfully",
    "data": {
        "id": "019d60f6-ff4b-727d-ad51-cda4c41750b0",
        "client_transaction_id": "87b2b208-a8e6-4185-90ba-67629a95eb49",
        "neokred_transaction_id": "87b2b208-a8e6-4185-90ba-67629a95eb50",
        "client_id": "ab937578-6553-4c46-8148-553869e1d88f",
        "user_id": "87b2b208-a8e6-4185-90ba-67629a95eb48",
        "account_holder_name": "Ravinder Joshi",
        "account_number": "987654321123",
        "ifsc_code": "SBIN0000031",
        "bank_name": "State Bank Of India",
        "amount": "100.00",
        "status": "PENDING",
        "currency": "INR",
        "utr": null,
        "remark": "remark",
        "metadata": null,
        "created_at": "2026-04-05T22:34:53.196Z",
        "updated_at": "2026-04-05T22:34:53.196Z"
    }
}

Response Payload Details

Property Name	Type	Description
`id`	`uuid`	Swiftramp’s internal unique identifier for the transaction.
`client_transaction_id`	`string`	Your internal unique identifier for the transaction.
`status`	`enum`	Current state: `PENDING`, `PROCESSING`, `SUCCESS`, `FAILED`.
`amount`	`decimal`	The transaction amount.
`utr`	`string`	The Unique Transaction Reference provided by the bank upon completion.

Enums and Constants

Transaction Status

Value	Description
`PENDING`	Transaction has been initiated and is awaiting processing.
`PROCESSING`	Transaction is currently being handled by the banking network.
`SUCCESS`	Transaction has been successfully completed.
`FAILED`	Transaction failed to complete.

💡 Path Parameter: Replace [ID] in the URL with your internal transaction identifier (client_transaction_id).
💡 Reconciliation: This endpoint is the primary tool for reconciling transactions between your system and Swiftramp.
💡 Authorization: A valid Bearer token is required in the Authorization header.

Get Transactions by UserId