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
Name | Type | Parameter type | Required | Range | Description |
---|---|---|---|---|---|
code | string | QUERY | YES | - | 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
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 23 days ago