Customer Transaction History

History Data

curl --request POST \
  --url https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
{
  "fromAmount": 0.1,
  "toAmount": 100000000,
  "fromDate": "2025-09-21",
  "toDate": "2025-11-20",
  "totalNumber": 200,
  "startNumber": 1,
  "customerCode": "<string>"
}
'

import requests

url = "https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data"

payload = {
    "fromAmount": 0.1,
    "toAmount": 100000000,
    "fromDate": "2025-09-21",
    "toDate": "2025-11-20",
    "totalNumber": 200,
    "startNumber": 1,
    "customerCode": "<string>"
}
headers = {
    "platform": "<platform>",
    "uuid": "<uuid>",
    "X-Auth-Token": "<x-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    platform: '<platform>',
    uuid: '<uuid>',
    'X-Auth-Token': '<x-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    fromAmount: 0.1,
    toAmount: 100000000,
    fromDate: '2025-09-21',
    toDate: '2025-11-20',
    totalNumber: 200,
    startNumber: 1,
    customerCode: '<string>'
  })
};

fetch('https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data', 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://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromAmount' => 0.1,
    'toAmount' => 100000000,
    'fromDate' => '2025-09-21',
    'toDate' => '2025-11-20',
    'totalNumber' => 200,
    'startNumber' => 1,
    'customerCode' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Auth-Token: <x-auth-token>",
    "platform: <platform>",
    "uuid: <uuid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data"

	payload := strings.NewReader("{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("platform", "<platform>")
	req.Header.Add("uuid", "<uuid>")
	req.Header.Add("X-Auth-Token", "<x-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data")
  .header("platform", "<platform>")
  .header("uuid", "<uuid>")
  .header("X-Auth-Token", "<x-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

POST

transactionmanagement

history-data

History Data

curl --request POST \
  --url https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
{
  "fromAmount": 0.1,
  "toAmount": 100000000,
  "fromDate": "2025-09-21",
  "toDate": "2025-11-20",
  "totalNumber": 200,
  "startNumber": 1,
  "customerCode": "<string>"
}
'

import requests

url = "https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data"

payload = {
    "fromAmount": 0.1,
    "toAmount": 100000000,
    "fromDate": "2025-09-21",
    "toDate": "2025-11-20",
    "totalNumber": 200,
    "startNumber": 1,
    "customerCode": "<string>"
}
headers = {
    "platform": "<platform>",
    "uuid": "<uuid>",
    "X-Auth-Token": "<x-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    platform: '<platform>',
    uuid: '<uuid>',
    'X-Auth-Token': '<x-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    fromAmount: 0.1,
    toAmount: 100000000,
    fromDate: '2025-09-21',
    toDate: '2025-11-20',
    totalNumber: 200,
    startNumber: 1,
    customerCode: '<string>'
  })
};

fetch('https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data', 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://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromAmount' => 0.1,
    'toAmount' => 100000000,
    'fromDate' => '2025-09-21',
    'toDate' => '2025-11-20',
    'totalNumber' => 200,
    'startNumber' => 1,
    'customerCode' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Auth-Token: <x-auth-token>",
    "platform: <platform>",
    "uuid: <uuid>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data"

	payload := strings.NewReader("{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("platform", "<platform>")
	req.Header.Add("uuid", "<uuid>")
	req.Header.Add("X-Auth-Token", "<x-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data")
  .header("platform", "<platform>")
  .header("uuid", "<uuid>")
  .header("X-Auth-Token", "<x-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fromAmount\": 0.1,\n  \"toAmount\": 100000000,\n  \"fromDate\": \"2025-09-21\",\n  \"toDate\": \"2025-11-20\",\n  \"totalNumber\": 200,\n  \"startNumber\": 1,\n  \"customerCode\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Retrieves the transaction history with support for filtering by amount, date, currency, status, and more. Uses POST so the filtering parameters can be sent in the request body.

Request Headers

string

required

JWT Access Token of the authenticated user.

string

default:"fincode"

required

Platform identifier. Use fincode.

string

default:"200"

required

Unique request identifier.

Request Body

All fields are optional — omit any you do not need to filter by.

integer

Number of records to return (page size). Defaults to all matching records if omitted.

integer

Zero-based offset for pagination. Use with totalNumber to page through results.

string

Start of the date range (ISO 8601 format, e.g. 2024-01-01T00:00:00Z).

string

End of the date range (ISO 8601 format, e.g. 2024-12-31T23:59:59Z).

number

Minimum transaction amount filter.

number

Maximum transaction amount filter.

string

ISO 4217 currency code to filter by (e.g. GBP, NGN).

string

Filter by transaction status. Common values: PENDING, PROCESSED, FAILED, CANCELLED.

string

Filter by delivery/transaction type (e.g. ACCOUNTPAYMENT, MOBILE_MONEY, CASH_PICKUP).

string

ISO 3166-1 alpha-3 destination country code filter (e.g. NGA).

string

Filter by transaction reference / PCN (Platform Control Number).

string

Filter by recipient account number.

string

Filter by recipient’s customer code.

string

Filter by sender’s full name (partial match).

string

Filter by recipient’s full name (partial match).

string

Filter by compliance check status.

Code Example

cURL

curl -X POST 'https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/history-data' \
--header 'X-Auth-Token: YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--header 'platform: fincode' \
--header 'uuid: 200' \
--data '{
  "startNumber": 0,
  "totalNumber": 20,
  "fromDate": "2024-01-01T00:00:00Z",
  "toDate": "2024-12-31T23:59:59Z",
  "selectedCurrency": "GBP",
  "status": "PROCESSED"
}'

Headers

platform

string

default:fincode

required

uuid

string

default:200

required

X-Auth-Token

string

required

Body

application/json

fromAmount

number

default:0.1

required

toAmount

number

default:100000000

required

fromDate

string

default:2025-09-21

required

toDate

string

default:2025-11-20

required

totalNumber

number

default:200

required

startNumber

number

default:1

required

customerCode

string

Response

200

Transaction history

Getting Started

Transaction Core

API Endpoints

Request Headers

Request Body

Code Example

Headers

Body

Response

​Request Headers

​Request Body

​Code Example

Headers

Body

Response

Request Headers

Request Body

Code Example