GET/v1/translations/searchTier · Developer

Search Translations

Find filings whose translated text matches a query.

Searches every English-translated section across all filings, ranks by Postgres relevance (tsvector/tsquery), and returns each hit with a highlighted snippet, the source doc_id, section name, and fiscal year. Filter scope by section (e.g. only risk-factor mentions) or fiscal_year when needed.

Use it to find narrative disclosures across the universe: e.g. "which issuers mentioned a specific supplier or covenant?"

Query parameters · 5

Optional filters and modifiers. Pass as URL-encoded ?key=value.

qstringrequired

Search query

sectionstring | nulloptional

Filter by section

fiscal_yearinteger | nulloptional

Filter by fiscal year

limitintegeroptional

default 20

offsetintegeroptional

default 0

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of TranslationSearchResult.

Envelope

dataTranslationSearchResult[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

TranslationSearchResult

sectionstring

Filing section where the match was found.

snippetstring

Text snippet with matching terms highlighted.

edinet_codestring

EDINET submitter code of the matched company.

company_namestring | null

Company name in Japanese.

fiscal_yearinteger

Fiscal year of the matched filing.

doc_idstring

EDINET document ID of the matched filing.

ranknumber

PostgreSQL ts_rank relevance score. Higher means more relevant.

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.

RequestcURL

curl "https://api.axiora.dev/v1/translations/search?q=value" \
  -H "Authorization: Bearer ax_live_…"

Response · 200

200 OK

{
  "data": [
    {
      "section": "…",
      "snippet": "…",
      "edinet_code": "…",
      "company_name": null,
      "fiscal_year": 0,
      "doc_id": "…",
      "rank": 0
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "total": 1,
    "limit": 50,
    "offset": 0,
    "next_cursor": null,
    "data_as_of": "2026-05-12T03:25:11Z",
    "ontology_version": "2.1.0",
    "as_of": "frz_01HRX9KQ2T8N7P4M"
  }
}

Response · 401

401 UNAUTHORIZED

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key. Pass it as `Authorization: Bearer ax_live_…`."
  }
}