Transactions

Get List of Transactions for an Account

get

Retrieve a paginated list of transactions for a specific account.

Authorizations

api_key

api_keystringRequired

Path parameters

accountIdstringRequired

Unique identifier of the account

Query parameters

pageintegerOptional

Page number of the transactions list

pageSizeintegerOptional

Number of transactions per page

Responses

200

A list of transactions for the specified account

application/json

totalintegerOptional

Total number of transactions for the account

totalPagesintegerOptional

Total number of pages

currentPageintegerOptional

Current page number

404

Account not found

get

/account/{accountId}/transactions

HTTPcURLJavaScriptPython

GET /v1/account/{accountId}/transactions HTTP/1.1
Host: api.example.com
api_key: YOUR_API_KEY
Accept: */*

{
  "transactions": [
    {
      "id": "text",
      "type": "recharge",
      "amount": 1,
      "timestamp": "2026-03-13T12:01:29.388Z"
    }
  ],
  "total": 1,
  "totalPages": 1,
  "currentPage": 1
}

Add funds to an account

post

Endpoint to add funds to a specific account. This involves a payment transaction which, upon successful completion, updates the account balance.

Authorizations

api_key

api_keystringRequired

Path parameters

accountIdstringRequired

Account ID

Body

application/json

amountnumber · floatRequiredExample: 100

Responses

200

Funds added successfully

application/json

transaction_idstringOptionalExample: txn_123456789

updated_balancenumber · floatOptionalExample: 200

400

Invalid input or account not found

post

/account/{accountId}/transactions/add-funds

HTTPcURLJavaScriptPython

POST /v1/account/{accountId}/transactions/add-funds HTTP/1.1
Host: api.example.com
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "amount": 100
}

{
  "transaction_id": "txn_123456789",
  "updated_balance": 200
}

Record account usage

post

Endpoint to record the usage of services against an account.

Authorizations

api_key

api_keystringRequired

Path parameters

accountIdstringRequired

Account ID

Body

application/json

detailsstringRequiredExample: 100 tokens

amountnumber · floatRequiredExample: 15.75

datestring · timestampRequiredExample: 2010-01-01 00.00:00

metadataobjectOptional

Responses

200

Usage recorded successfully

application/json

statusstringOptionalExample: Usage recorded successfully

new_balancenumber · floatOptionalExample: 284.25

400

Invalid input or account not found

post

/account/{accountId}/transactions/record-usage

HTTPcURLJavaScriptPython

POST /v1/account/{accountId}/transactions/record-usage HTTP/1.1
Host: api.example.com
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "details": "100 tokens",
  "amount": 15.75,
  "date": "2010-01-01 00.00:00",
  "metadata": {}
}

{
  "status": "Usage recorded successfully",
  "new_balance": 284.25
}