Developer Docs

Quickstart Guide

The Axiom AI API delivers verified, structured answers to natural language questions in milliseconds. Sign up for a free key, pass it as a bearer token, and ask one verified question at a time.

Base URL

axiomai.nanocorp.app

Protocol

HTTPS only

Auth

Bearer API key

Format

JSON

Query the API

Send a GET request with your API key in the Authorization header and your question as the q parameter.

GEThttps://axiomai.nanocorp.app/api/query

Name	Location	Required	Description
Authorization	header	required	Bearer token from your free API key, for example `Bearer axm_...`.
q	query	required	The natural language question to look up. URL-encoded.

Sample Request

Replace the placeholder with the key returned by signup to make your first query.

terminal

$ curl "https://axiomai.nanocorp.app/api/query?q=What%20is%20a%20JWT%20token%3F" \
  -H "Authorization: Bearer axm_your_api_key_here"

Works with any HTTP client — fetch, axios, requests, curl, wget, or your favorite SDK.

JavaScript

const res = await fetch(
  "https://axiomai.nanocorp.app/api/query?q=" +
  encodeURIComponent("What is a JWT token?"),
  { headers: { Authorization: "Bearer axm_your_api_key_here" } }
);
const data = await res.json();

Python

import requests

res = requests.get(
    "https://axiomai.nanocorp.app/api/query",
    params={"q": "What is a JWT token?"},
    headers={"Authorization": "Bearer axm_your_api_key_here"},
)
data = res.json()

Sample Response

A successful query returns a structured JSON object with the answer and metadata.

response.json

{
  "found": true,
  "query": "What is a JWT token?",
  "question": "What is a JWT token?",
  "answer_short": "A JWT, or JSON Web Token, is a compact claims format commonly used to represent signed identity or authorization information.",
  "answer_detailed": "JWTs are often used as bearer tokens or ID tokens. The payload contains claims such as issuer, subject, audience, expiration, and application-specific attributes.",
  "domain": "security",
  "confidence_score": 1,
  "verified": true,
  "source_url": "https://www.rfc-editor.org/rfc/rfc7519",
  "match_strategy": "exact"
}

Response Fields

foundbooleanWhether a matching entry was found in the knowledge base.

querystringThe raw query string you submitted.

answer_shortstringConcise answer — ideal for AI agent consumption.

answer_detailedstringFull answer with context and elaboration.

confidence_scorenumberMatch confidence from 0.0 to 1.0.

verifiedbooleanWhether the answer has been manually verified.

match_strategystringHow the match was found: exact, ilike, or fts.

404No match found

{
  "found": false,
  "query": "your query here",
  "message": "No knowledge entry matched the supplied question."
}

Free Tier

Get started immediately — no credit card, no waitlist.

✓

Free Tier — Always Available

No credit card required. No time limit.

100

queries / day

Resets at midnight UTC

< 50ms

response time

p50 latency, globally

rate limits

Up to your daily quota

Free

forever

No trial period

Need more? Paid plans start at $29/mo for 10,000 queries/day. See pricing for details.

Get Started

Request your free API key — no credit card required. We'll get back to you within 24 hours with your key and rate limit details.

Request API Key→View Paid Plans

Or email us directly at api@axiomai.ai