NextName Kennisbank
NextName Kennisbank
+31 (0)36 785 13 70 Control panel Hoofdsite Aanmelden

Finance : Transactions

  • Aangemaakt: 20-07-2026

Omschrijving

Haal de financiële transacties van het account op: registraties, verlengingen, verhuizingen en overige mutaties, elk met het verrekende bedrag in de valuta van je account en het oorspronkelijke bedrag in de bronvaluta.

Endpoint

URL parameters

Alle parameters zijn optioneel en werken als zoekwaarden om de lijst te filteren. Bekijk voor de volledige syntax van zoekwaarden, operatoren en paginering de pagina Zoekopdrachten.

Parameter Datatype Omschrijving
transaction_id String Zoekwaarde voor de unieke ID van de transactie
transaction_type Array Zoekwaarde voor het type transactie, mogelijk waarden domain, ssl, spamexperts en account
transaction_sub_type Array Zoekwaarde voor het subtype, mogelijke waarden: registration, transfer, renewal, subscription, idprotect, trustee, trade, transfer_quarantaine, restore, registration_premium, transfer_premium, renewal_premium, deposit_manual, deposit_automatic
object String Zoekwaarde voor het object waarop de transactie betrekking heeft (bijvoorbeeld een domeinnaam)
transaction_date String Zoekwaarde voor de datum van de transactie, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339

Antwoord

Parameter Type Omschrijving
Array: data[] met object:
transaction_id String Unieke ID van de transactie
transaction_type String Het type transactie, bijvoorbeeld domain
transaction_sub_type String Het subtype van de transactie, bijvoorbeeld registration, renewal of transfer
object String Het object waarop de transactie betrekking heeft (bijvoorbeeld een domeinnaam), of null als dit niet van toepassing is
transaction_date Datetime Datum en tijdstip van de transactie in UTC tijdzone volgens RFC 3339
transaction_price Object Het bedrag dat voor deze transactie in de valuta van je account is verrekend:
currency: valutacode (ISO 4217) van je account
price: het bedrag; een negatief bedrag is een afschrijving (prepaid accounts), een positief bedrag een bijschrijving (postpaid accounts)
native_price Object Het bedrag in de oorspronkelijke valuta van de transactie:
currency: valutacode (ISO 4217) van de bronvaluta
price: het bedrag in de bronvaluta
exchange_rate: de toegepaste wisselkoers ten opzichte van je account-valuta (1 bij gelijke valuta)
period Object De dienstperiode waarop de transactie betrekking heeft:
start: startdatum (YYYY-MM-DD)
end: einddatum (YYYY-MM-DD)
months: de duur van de periode in maanden
Dit object is null bij transacties zonder dienstperiode
Object: pagination
current_page Integer Huidige pagina
per_page Integer Aantal resultaten per pagina
total_pages Integer Totaal aantal pagina's
total_results Integer Totaal aantal resultaten

Voorbeelden

Beschrijving:
Haal de lijst met transacties van een prepaid account op. Het verrekende bedrag (transaction_price) is negatief: een afschrijving van het prepaid-saldo.

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/transactions";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/finance/transactions

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
{
  "data": [
    {
      "transaction_id": "1c968af45c8cbfe3",
      "transaction_type": "domain",
      "transaction_sub_type": "registration",
      "object": "testdomeinnaam.nl",
      "transaction_date": "2026-06-30T14:33:37Z",
      "transaction_price": {
        "currency": "EUR",
        "price": -6.57
      },
      "native_price": {
        "currency": "EUR",
        "price": 6.57,
        "exchange_rate": 1
      },
      "period": {
        "start": "2026-06-30",
        "end": "2027-06-30",
        "months": 12
      }
    },
    {
      "transaction_id": "1523e91fb34850e7",
      "transaction_type": "domain",
      "transaction_sub_type": "registration",
      "object": "testdomeinnaam.com",
      "transaction_date": "2026-06-30T14:31:18Z",
      "transaction_price": {
        "currency": "EUR",
        "price": -11.92
      },
      "native_price": {
        "currency": "USD",
        "price": 13.59,
        "exchange_rate": 1.14
      },
      "period": {
        "start": "2026-06-30",
        "end": "2027-06-30",
        "months": 12
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 2
  }
}

Beschrijving:
Haal de lijst met transacties van een postpaid account op. Identiek aan het prepaid-voorbeeld, maar het verrekende bedrag (transaction_price) is positief: een bijschrijving op de openstaande rekening.

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/finance/transactions";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/finance/transactions

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
{
  "data": [
    {
      "transaction_id": "1c968af45c8cbfe3",
      "transaction_type": "domain",
      "transaction_sub_type": "registration",
      "object": "testdomeinnaam.nl",
      "transaction_date": "2026-06-30T14:33:37Z",
      "transaction_price": {
        "currency": "EUR",
        "price": 6.57
      },
      "native_price": {
        "currency": "EUR",
        "price": 6.57,
        "exchange_rate": 1
      },
      "period": {
        "start": "2026-06-30",
        "end": "2027-06-30",
        "months": 12
      }
    },
    {
      "transaction_id": "1523e91fb34850e7",
      "transaction_type": "domain",
      "transaction_sub_type": "registration",
      "object": "testdomeinnaam.com",
      "transaction_date": "2026-06-30T14:31:18Z",
      "transaction_price": {
        "currency": "EUR",
        "price": 11.92
      },
      "native_price": {
        "currency": "USD",
        "price": 13.59,
        "exchange_rate": 1.14
      },
      "period": {
        "start": "2026-06-30",
        "end": "2027-06-30",
        "months": 12
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 2
  }
}