Get Transactions
curl --request GET \
--url https://api.rolla.xyz/api/v1/external/transactions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.rolla.xyz/api/v1/external/transactions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.rolla.xyz/api/v1/external/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rolla.xyz/api/v1/external/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rolla.xyz/api/v1/external/transactions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rolla.xyz/api/v1/external/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": 200,
"success": true,
"message": "Transactions retrieved successfully",
"transactions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transaction_type": "deposit",
"status": "pending",
"description": "<string>",
"external_reference": "<string>",
"fee_amount": 123,
"fee_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fee_reference": "FEE-9J76UADV",
"related_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"related_reference": "<string>",
"source_amount": 123,
"destination_amount": 123,
"source_currency": "<string>",
"destination_currency": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"totalCount": 150,
"page": 1,
"pageSize": 20,
"totalPages": 8
}{
"success": false,
"message": "<string>"
}Transactions
Get Transactions
Retrieves a paginated list of transactions with optional filtering.
GET
/
transactions
Get Transactions
curl --request GET \
--url https://api.rolla.xyz/api/v1/external/transactions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.rolla.xyz/api/v1/external/transactions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.rolla.xyz/api/v1/external/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rolla.xyz/api/v1/external/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rolla.xyz/api/v1/external/transactions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rolla.xyz/api/v1/external/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": 200,
"success": true,
"message": "Transactions retrieved successfully",
"transactions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transaction_type": "deposit",
"status": "pending",
"description": "<string>",
"external_reference": "<string>",
"fee_amount": 123,
"fee_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"fee_reference": "FEE-9J76UADV",
"related_transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"related_reference": "<string>",
"source_amount": 123,
"destination_amount": 123,
"source_currency": "<string>",
"destination_currency": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"totalCount": 150,
"page": 1,
"pageSize": 20,
"totalPages": 8
}{
"success": false,
"message": "<string>"
}Retrieve a paginated list of your transactions with optional filtering by status and date range.
Example Request
curl -X GET "https://api.rolla.xyz/api/v1/external/transactions?page=1&pageSize=20&status=completed" \
-H "X-API-Key: your_api_key_here"
Query Parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
pageSize | integer | Results per page (default: 20, max: 100) |
status | string | Filter by status: pending, completed, failed |
startDate | string | Start date filter (ISO 8601 format) |
endDate | string | End date filter (ISO 8601 format) |
Example Response
{
"status": 200,
"success": true,
"message": "Transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"transaction_type": "withdrawal",
"status": "completed",
"description": "Vendor payment",
"external_reference": "ref-abc123",
"fee_amount": 53,
"source_amount": 500000,
"destination_amount": 499947,
"source_currency": "NGN",
"destination_currency": "NGN",
"created_at": "2024-01-15T10:30:00.000Z",
"updated_at": "2024-01-15T10:30:45.000Z"
}
],
"totalCount": 150,
"page": 1,
"pageSize": 20,
"totalPages": 8
}
}
Use date range filters to export transaction data for specific periods. Combine with status filter to find failed transactions that may need to be retried.
Authorizations
Your Rolla API key
Query Parameters
Page number (default: 1)
Number of results per page (default: 20)
Filter by transaction status
Available options:
pending, completed, failed Filter transactions from this date (ISO 8601 format)
Filter transactions until this date (ISO 8601 format)
Response
Transactions retrieved successfully
Example:
200
Example:
true
Example:
"Transactions retrieved successfully"
Show child attributes
Show child attributes
Total number of transactions
Example:
150
Current page number
Example:
1
Results per page
Example:
20
Total number of pages
Example:
8
⌘I