Primus Documentation

Get Transaction by Account ID API

Welcome to the documentation for the Get Transaction by Account ID API. This API allows users to retrieve a list of transactions associated with a specific account ID, with pagination and sorting options.

Base URL

The base URL for this API is {baseURL}/v1/transaction/get_transaction_by_account_id.

Endpoint

Path: /
Method: GET

Query Parameters

limit: The maximum number of transactions to retrieve per page.
page: The page number to retrieve.
sort: The sorting order for the transactions. Use asc for ascending order and desc for descending order.

Authorization

Include the following Authorization header in your HTTP requests using a Bearer token:

Authorization: Bearer YOUR_ACCESS_TOKEN

Sample Request

curl -X GET '{baseURL}/v1/transaction/get_transaction_by_account_id?limit=1&page=1&sort=asc' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'  
  -H 'accept: application/json' \

Sample 200 Response

{
    "message": "Transaction fetched successful.",
    "data": {
        "transfers": [
            {
                "transfer_request_id": "6874c2d3-df20-48c0-bb95-56ed421a2eba",
                "account_id": "65db5b5041a636af9ee5feb2",
                "narration": "string",
                "amount": "20000",
                "organization_id": "65db532d41a636af9ee5feaf",
                "transaction_reference": "3GYCFBFAJHL1",
                "destination_bank_code": "056",
                "destination_account_name": "prince",
                "destination_account_type": "savings",
                "destination_bank_name": "GTB",
                "destination_account_number": "0354882788",
                "originating_account_number": "00510011011003213",
                "originating_account_name": "Jolaoso",
                "transfer_type": "intra",
                "provider_id": "64dfdf50c013a4fc3828678a",
                "session_id": "1234566",
                "provider_response_id": null,
                "transfer_status_id": null,
                "tsq_requery_count": 0,
                "transfer_request_decision_id": null,
                "mandate_rule_id": null,
                "status": "failed",
                "transfer_status": "failed",
                "created_at": "2024-02-25T15:26:35.017Z",
                "updated_at": "2024-02-25T17:00:49.352Z"
            }
        ],
        "meta": {
            "total": 1,
            "limit": 1,
            "page": 1
        }
    },
    "success": true
}

Get All Transactions Initiate Transaction