# TruthBear SEC EDGAR Filing Resolution

> TruthBear SEC EDGAR Filing Resolution is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.09/call, status unknown (last checked 2026-09-13).

Checks whether a public company filed a specific SEC EDGAR form before a given cutoff date and returns structured settlement evidence for prediction markets and dispute workflows.

## Facts

- Endpoint: GET https://api.truthbear.co/resolve
- Price: $0.09/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-sec-edgar-filing-resolution-04cc31f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cP6EvJ-Bqfz9PcQjFUFMF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability truthbear-sec-edgar-filing-resolution-04cc31f3
```

Example prompt: Did Apple (AAPL) file a 10-K with the SEC before January 1, 2025? I need the resolution status and timestamps for a prediction market settlement.

## When to prefer this

Use this endpoint when you need authoritative, timestamped evidence of whether a specific SEC EDGAR filing occurred before a defined cutoff — particularly for settling prediction markets, resolving disputes, or verifying compliance. It is ideal when you need a structured resolution_status (not a forecast) and when the filing type and issuer are well-defined. Prefer this over general web search when you need machine-readable settlement evidence with source citations.

## Known failure modes

- 422 with no_charge status when no matching filing data exists for the given entity, form, and cutoff
- Invalid ticker or CIK returns an error or no_authoritative_source status
- Unsupported form types may return ambiguous or no_authoritative_source
- Malformed cutoff date (non-ISO 8601) causes a validation error
- Edge cases around exact cutoff timestamps may yield ambiguous status

## How this service works

Settlement evidence v0 for prediction-market and dispute workflows: did an issuer file a given SEC EDGAR form before your cutoff? Returns THREE SEPARATED TIMES (event / disclosure / cutoff), a resolution_status of resolved, no_authoritative_source, ambiguous or conflicting, and candidate_sources. We describe the filing record; we never adjudicate the real-world event. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.09 per call.

## Output

Returns a JSON object with three timestamps (event time, disclosure time, and cutoff time), a resolution_status of 'resolved', 'no_authoritative_source', 'ambiguous', or 'conflicting', and a list of candidate_sources with filing record details from SEC EDGAR. No charge (422) if no data is found.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
      "entity": {
       "type": "string",
       "description": "required - ticker or CIK (e.g. AAPL or 320193)",
       "examples": [
        "AAPL"
       ]
      },
      "form": {
       "type": "string",
       "description": "required - filing type (e.g. 10-K, 8-K, NT 10-K, SC 13D, 4)",
       "examples": [
        "10-K"
       ]
      },
      "cutoff": {
       "type": "string",
       "description": "required - settlement cutoff, ISO 8601 (e.g. 2026-07-31 or 2026-07-31T23:59:59Z)",
       "examples": [
        "2025-01-01"
       ]
      },
      "event_class": {
       "type": "string",
       "description": "optional - 8-K item (e.g. 1.03 bankruptcy)"
      },
      "source_class": {
       "type": "string",
       "description": "optional - defaults to sec-edgar (the only source in v0)"
      },
      "market_or_event": {
       "type": "string",
       "description": "optional - market/event label, echoed back verbatim"
      }
     },
     "required": [
      "entity",
      "form",
      "cutoff"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "queryParams"
   ]
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    }
   },
   "required": [
    "type"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truthbear-sec-edgar-filing-resolution-04cc31f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)
