Guides
Guides

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:

code: 'CODE_NOT_FOUND'

Exemplary request

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

const url = "https://api.kuna.io";
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(showResponse.data));

import requests

api_key = "YOUR_API_KEY"  # put here your Api key

url = "https://api.kuna.io"
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)
print(request.json()))

How to call private endpoints here

Swagger here

Response

{
  "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.
}

Updated about 1 month ago