RoboLedger: Analytical Views

Search Text

Every place one filing's whole text says something, in document order, with the surrounding text and the section each match falls in; on no match, how often each word of the query occurs alone. The query is words matched in order across any spacing (| between alternative phrases, a trailing * for a stem), not a regular expression. On the SEC shared repository the text is the filing's own document — cover page, footnotes and exhibits included — so this finds what no indexed section carries. Same filing selection as describe-filing.

Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

post/extensions/roboledger/{graph_id}/operations/search-text

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/extensions/roboledger/{graph_id}/operations/search-text
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

tickerstring nullable

Company ticker. On shared-repository graphs (SEC) it resolves the latest matching filing when report_id is not given; ignored on tenant graphs.

report_idstring nullable

Specific report identifier. Required on tenant graphs; on SEC, optional when ticker is given.

fiscal_yearinteger nullable

Narrow auto-resolution to this fiscal year focus

period_typestring nullable

Which forms auto-resolution considers: annual (10-K / 20-F / 40-F, the default) or quarterly (10-Q as well)

accessionstring nullable

SEC only, with ticker: one filing by accession number — a report, or an 8-K from resolved_report.recent_releases

formstring nullable

SEC only, with ticker: '8-K' reads the latest earnings release, or with fiscal_year the latest filed in that calendar year

querystring required

Words matched in order across any spacing, case-insensitive; | between alternative phrases, a trailing * for a stem. Not a regular expression.

windowinteger nullable

Characters of context around each match (default 300)

max_hitsinteger nullable

Matches to return (default 10)

Response

Successful Response

operationstring required

Kebab-case operation name

operationIdstring required

op_-prefixed ULID for audit and SSE correlation

status'completed' | 'pending' | 'failed' required

Operation lifecycle state

atstring required

ISO-8601 UTC timestamp

createdBystring nullable

User ID that initiated the operation

idempotentReplayboolean

True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.

Changes

No recorded changes to this operation across all 1 revision of this API.