On this page

Docs / API

API

Ruleset v1.2.0. Engine 1.2.0. Group: Contract.

Base URL: https://ai.axioraworld.com/api/v1/. Catalog methods are GET and HEAD. The error shape is {"error":{"code","message"}}. GET /api/v1/session without a cookie is 401 {"error":"unauthenticated"}, a different shape. This page is the contract until schemas exist.

Parent catalog

Organization, products, offers, policies, support, industries, solutions, pages, journal, commerce capabilities, and search describe the parent store. Support on the organization record is axioraindia@gmail.com. AXIORA AI support is support@axioraworld.com. Search is in that available list.

Search

GET /api/v1/search?q= is lexical catalog search for this tenant. q is required and must be 1 to 200 visible characters. limit defaults to 10 and max is 50. offset pages through the same ranking. entity_type accepts organization, product, service, policy, faq, and location. service selects solutions. location selects the organization, support, and the legal policy. Each result has type, id (the canonical id), title, summary, canonical_url, status, score, and match_type, plus public offer or policy fields when those exist. Internal search text, tenant private fields, and payment records are not returned. Anonymous calls see visibility public only. Restricted rows need an authenticated tenant principal and are not on this anonymous route. Private rows are omitted. The caller cannot pass tenant_id. An empty match is HTTP 200 with data []. Missing q is HTTP 400 invalid_query. A query of only punctuation is HTTP 400 invalid_query. Unknown parameters are HTTP 400 invalid_filter. Search is 60 requests a minute per direct peer, then HTTP 429 rate_limited. Responses use Cache-Control no-store. Exact title, canonical id, slug, and approved alias outrank a prefix. A prefix needs 4 characters. Fuzzy match allows edit distance 1 below 8 characters and 2 at 8 or more, and only for tokens of 4 or more. It does not rank above an exact title. Aliases are the approved rows in the AXIORA alias table. They are not copied to another tenant. Ranking is deterministic hybrid-search/1. It does not call a model. mode=hybrid is a separate retrieval path and is not the default. If the index file is absent, search leaves the catalog list and a query returns HTTP 503 search_unavailable with the message “Catalog search is not available yet.” That body is not a result list. RAG stays Preview.

curl -sS https://ai.axioraworld.com/api/v1/organization

Previous: Agent quickstartNext: MCP