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
  });

PreviousReceive Invoices Transactions NextCreate Invoice

Last updated 4 months ago