Receive Single Invoice Transactions
GET /invoice/{identifier}/transactions
Get all transactions for single invoice.
The identifier should be an id or uuid
Headers
Name
Value
Content-Type
application/json
X-API-KEY
<token>
Query params
Name
Type
Description
start_date
date, datetime
Start date for transactions
end_date
date, datetime
End date for transactions
Response
[
{
"id": 0,
"source_type": "invoice",
"source": {
"id": 0,
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"currency": "USDTBEP20",
"tx_hash": null,
"address": "0x...",
"amount": 0,
"amount_usd": 0,
"received_amount": 0,
"received_amount_usd": 0,
"label": "Order #123",
"postback_url": "https://example.com/postback",
"success_url": "https://example.com/success",
"fail_url": "https://example.com/fail",
"created_at": "2025-06-20T14:22:10.345678Z",
"expires_at": "2025-07-20T14:22:10.345678Z",
"status": "paid"
},
"currency": {
"name": "USDTBEP20",
"token": "USDT",
"network": "BEP20",
"contract": "0x55d398326f99059fF775485246999027B3197955",
"decimals": 18,
"confirmations": 5,
"network_fee": 0,
"min_deposit": 1
},
"amount": 0,
"amount_usd": 0,
"network_fee": 0,
"network_fee_usd": 0,
"service_fee": 0,
"service_fee_usd": 0,
"tx_hash": "0x...",
"is_paid": true,
"is_postback_sended": false,
"created_at": "2025-06-20T15:22:10.345678Z"
},
...
]{
"detail": [
{
"loc": [],
"msg": "string",
"type": "string",
"ctx": {
"error": "string"
}
}
]
}Example
curl -X GET "https://api.nord-pay.com/invoice/your-invoice-id-or-uuid/transactions" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY"curl -X GET "https://api.nord-pay.com/invoice/your-invoice-id-or-uuid/transactions?start_date=2021-01-01&end_date=2021-01-31" \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY"import requests
def get_invoice_transactions(identifier, start_date=None, end_date=None):
url = f"https://api.nord-pay.com/invoice/{identifier}/transactions"
headers = {
"Content-Type": "application/json",
"X-API-KEY": "YOUR_API_KEY"
}
params = {}
if start_date:
params["start_date"] = start_date
if end_date:
params["end_date"] = end_date
resp = requests.get(url, headers=headers, params=params)
resp.raise_for_status()
return resp.json()
# usage:
transactions = get_invoice_transactions("your-invoice-id-or-uuid", "2021-01-01", "2021-01-31")<?php
function getInvoiceTransactions(string $identifier, string $startDate = null, string $endDate = null): array {
$url = "https://api.nord-pay.com/invoice/{$identifier}/transactions";
$query = [];
if ($startDate) $query['start_date'] = $startDate;
if ($endDate) $query['end_date'] = $endDate;
if ($query) $url .= '?' . http_build_query($query);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: YOUR_API_KEY"
],
]);
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}
// usage:
$transactions = getInvoiceTransactions("your-invoice-id-or-uuid", "2021-01-01", "2021-01-31");async function loadInvoiceTransactions(identifier, startDate, endDate) {
const params = new URLSearchParams();
if (startDate) params.append('start_date', startDate);
if (endDate) params.append('end_date', endDate);
const url = `https://api.nord-pay.com/invoice/${identifier}/transactions` +
(params.toString() ? `?${params.toString()}` : '');
const response = await fetch(url, {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-API-KEY": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return response.json();
}
// usage:
loadInvoiceTransactions("your-invoice-id-or-uuid", "2021-01-01", "2021-01-31")
.then(transactions => {
// work with transactions
});const axios = require('axios');
async function getInvoiceTransactions(identifier, startDate, endDate) {
const { data } = await axios.get(
`https://api.nord-pay.com/invoice/${identifier}/transactions`,
{
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'YOUR_API_KEY'
},
params: {
start_date: startDate,
end_date: endDate
}
}
);
return data;
}
// usage:
getInvoiceTransactions("your-invoice-id-or-uuid", "2021-01-01", "2021-01-31")
.then(transactions => {
// work with transactions
});Last updated