Check Kuna Code by the first 5 symbols [Private]

This method allows to check the availability of the Kuna Code by its first segment, and also to find out the currency, amount, used it or not yet.


Available for Merchant accounts only!


To call any private endpoint, headers should include authorization key(s).

You may use a single API key or a public-private key pair based on your current tasks. Here you may find typical Header configurations for both options.

Method name:/v4/kuna-code/{code}/check
Request type:GET

Data dictionary

NameTypeParameter typeRequiredRangeDescription
codestringQUERYYES-First 5 symbols of the Kuna Code.


This endpoint allows to check any active Kuna Сode.

If the Kuna Code has already been activated, you will get an error:


Exemplary request

const apiKey = "YOUR_API_KEY"; // put here your Api key

const url = "";
const path = "/v4/kuna-code/XwBHu/check";
const options = {
  method: "GET",
  headers: {
    accept: "application/json",
    "Content-Type": "application/json",
    "api-key": apiKey,

fetch(url + path, options)
    .then((response) => response.json())
    .then((showResponse) => console.log(;
import requests

api_key = "YOUR_API_KEY"  # put here your Api key

url = ""
path = "/v4/kuna-code/XwBHu/check"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "api-key": api_key,

request = requests.get(url + path, headers=headers)

How to call private endpoints here

Swagger here


  "amount": 2,                              // Amount of the Kuna Сode.
  "asset": "usdt",                          // Currency of the Kuna Code.
  "comment": "for something",                    // Public note.
  "nonRefundableBefore": null,              // Time until which a code cannot be activated by the owner.
  "recipientId": "kunaid-s6awb4fp30n8",     // KUNA ID of the recipient. If 'null' then anyone can activate it.
  "code": "XwBHu"                           // First 5 symbols of the Kuna Code.