Transaction History API Documentation

This document explains how to retrieve the transaction history for your client account, including support for pagination and filtering.

Overview

The transaction/history endpoint allows you to fetch a list of all transactions associated with your client account. This is essential for reconciliation, reporting, and monitoring user activities.

Retrieve Transaction History

Description: Retrieves a paginated list of transaction history records.

Query Parameters

Parameter	Type	Mandatory	Description
`type`	`string`	No	The type of transactions to filter by. Supported value: `debit`.
`page`	`integer`	No	The page number to retrieve (defaults to 1).
`limit`	`integer`	No	The number of records per page (defaults to 10).

cURL Command

curl --request GET \
  --url 'https://api.swiftramp.in/v1/transaction/history?type=debit&page=1' \
  --header 'Authorization: Bearer [ACCESS_TOKEN]' \
  --header 'Content-Type: application/json'

Success Response (200 OK)

{
    "status": true,
    "code": 200,
    "message": "Transactions fetched successfully",
    "data": {
        "total_transactions": 12,
        "page": 1,
        "limit": 10,
        "total_pages": 2,
        "transactions": [
            {
                "id": "019e5e8a-0d0c-71ea-8b92-34552bb084b1",
                "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-05-25T04:19:26.156Z",
                "updated_at": "2026-05-25T04:19:26.156Z"
            }
        ]
    }
}

Response Payload Details (Based on Model Schema)

Property Name	Type	Description
`id`	`uuid`	Unique identifier for the transaction record.
`client_transaction_id`	`string(100)`	Client-provided unique transaction ID.
`neokred_transaction_id`	`string(100)`	Internal/Provider transaction ID.
`amount`	`decimal(12,2)`	The transaction amount.
`status`	`enum`	Current state: `PENDING`, `PROCESSING`, `SUCCESS`, `FAILED`.
`currency`	`string(3)`	Transaction currency (default: `INR`).
`utr`	`string(100)`	Unique Transaction Reference number (post-completion).
`remark`	`string(50)`	Optional transaction note.

Enums and Constants

Transaction Status

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

💡 Pagination: Use the page and limit parameters to navigate through large volumes of transaction data.
💡 Filter: The type parameter currently supports debit transactions.
💡 Authorization: A valid Bearer token is required in the Authorization header for all requests.

Direct Transaction Initiation Get Transactions by UserId