Skip to main content
GET
/
auth
/
verify
Verify API key
curl --request GET \
  --url https://versuno.ai/api/public/auth/verify \
  --header 'Authorization: <api-key>'
import requests

url = "https://versuno.ai/api/public/auth/verify"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://versuno.ai/api/public/auth/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://versuno.ai/api/public/auth/verify"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://versuno.ai/api/public/auth/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
require 'uri'
require 'net/http'

url = URI("https://versuno.ai/api/public/auth/verify")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body
HttpResponse<String> response = Unirest.get("https://versuno.ai/api/public/auth/verify")
.header("Authorization", "<api-key>")
.asString();
using RestSharp;


var options = new RestClientOptions("https://versuno.ai/api/public/auth/verify");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);
{
  "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "username": "kostek",
  "fullName": "Kostek Sytnyk",
  "email": "kostek@versuno.ai"
}
{
"error": "Invalid API key"
}
{
"error": "Not found"
}
Call this endpoint after the user provides an API key to your CLI or tool to confirm it is valid and to display who they are authenticated as.
Sensitive fields such as billing details, payment method, and social links are intentionally excluded from this response.

Authorizations

Authorization
string
header
default:Bearer uk_live_your_api_key_here
required

Versuno API key. Must be prefixed with Bearer. Format: Bearer uk_live_...

Response

API key is valid. Returns the caller's identity.

userId
string<uuid>

Unique identifier of the authenticated user.

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

username
string

The user's unique username.

Example:

"kostek"

fullName
string

The user's display name.

Example:

"Kostek Sytnyk"

email
string<email>

The user's email address.

Example:

"kostek@versuno.ai"