Filing search

POST/v1/filings/searchPromised whole

Search filing text and return matching passages with citations.

Response contract

Every field in the response is part of the contract.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

querycountsummaryuniversefiltersretrievalresults

How this was verified

Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl -X POST "https://api.massari.ai/v1/filings/search" \
  -H "Authorization: Bearer $MASSARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"revenue concentration","symbols":["AAPL"],"limit":3}'

Example response

{
  "query": "revenue concentration",
  "count": 0,
  "summary": null,
  "universe": {
    "mode": "symbols",
    "naicsCode": null,
    "symbolCount": 1,
    "entityTypesRequested": null,
    "entityTypesResolved": null
  },
  "filters": {
    "documentTypes": [
      "filing"
    ],
    "filingTypes": null,
    "sicCodes": null,
    "sections": null,
    "excludeSections": null,
    "since": null,
    "perSymbol": 1
  },
  "retrieval": {
    "strategy": "single-source-score-v1",
    "sourceBalanceApplied": false,
    "candidateCounts": {
      "filing": 0,
      "transcript": 0
    },
    "eligibleCounts": {
      "filing": 0,
      "transcript": 0
    },
    "resultCounts": {
      "filing": 0,
      "transcript": 0
    },
    "relevanceThresholds": {
      "filing": null,
      "transcript": null
    },
    "filingStatus": "no_matches",
    "transcriptStatus": "not_requested"
  },
  "results": []
}

A real response from the live API, captured August 18, 2026. Nothing was dropped, so this is the whole shape. Either way it is valid JSON.