List Transactions

List all transactions for your business.

Returns all transactions (on-ramp, off-ramp, buy, sell) for your business with pagination and filtering.

Endpoint

GET /v1/transactions

Authentication

Header

Value

x-api-key

Your API key

Query parameters

Parameter

Type

Required

Description

startPeriodDatetime

string

Start of date range (ISO 8601)

endPeriodDatetime

string

End of date range (ISO 8601)

page

number

Page number (default: 1)

limit

number

Items per page (default: 20)

search

string

Search by reference or email

Example request

curl -X GET "https://ramp-api.ivorypay.io/api/v1/transactions?page=1&limit=20" \
  -H "x-api-key: your_api_key"

const params = new URLSearchParams({
  page: "1",
  limit: "20",
});

const response = await fetch(`https://ramp-api.ivorypay.io/api/v1/transactions?${params}`, {
  method: "GET",
  headers: {
    "x-api-key": "your_api_key",
  },
});

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://ramp-api.ivorypay.io/api/v1/transactions",
    headers={
        "x-api-key": "your_api_key",
    },
    params={
        "page": 1,
        "limit": 20,
    },
)

print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://ramp-api.ivorypay.io/api/v1/transactions?page=1&limit=20", nil)
	req.Header.Set("x-api-key", "your_api_key")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": [
    {
      "id": "txn-uuid-1",
      "reference": "550e8400-e29b-41d4-a716-446655440000",
      "status": "SUCCESS",
      "feature": "ON_RAMP",
      "token": "USDT",
      "fiatCurrency": "NGN",
      "fiatAmount": 50000,
      "cryptoAmount": 31.25,
      "network": "BSC_MAINNET",
      "email": "amina@example.com",
      "createdAt": "2026-03-26T12:00:00.000Z"
    },
    {
      "id": "txn-uuid-2",
      "reference": "660e8400-e29b-41d4-a716-446655440001",
      "status": "PENDING",
      "feature": "OFF_RAMP",
      "token": "USDT",
      "fiatCurrency": "NGN",
      "fiatAmount": 100000,
      "cryptoAmount": 62.5,
      "network": "BSC_MAINNET",
      "email": "chidi@example.com",
      "createdAt": "2026-03-26T13:00:00.000Z"
    }
  ],
  "meta": {
    "total": 85,
    "page": 1,
    "limit": 20,
    "totalPages": 5
  }
}

Transaction features

Feature

Description

ON_RAMP

Fiat → Crypto

OFF_RAMP

Crypto → Fiat

BUY

Fiat collection

SELL

Fiat payout

PreviousGet Settlement by Deposit NextGet Transaction by ID

Last updated 1 month ago

hashtagEndpoint

hashtagAuthentication

hashtagQuery parameters

hashtagExample request

hashtagExample response

hashtagTransaction features

Endpoint

Authentication

Query parameters

Example request

Example response

Transaction features