# PreReason Company Briefing Block

> PreReason Company Briefing Block is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-16).

Returns one structured block of a company's financial briefing (header, what_changed, situations, numbers, valuation, etc.) for a given ticker or securities code

## Facts

- Endpoint: GET https://api.prereason.com/api/companies/:company/:block?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-company-briefing-block-803fcfe8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vtKAw04qeQEYp_j7Ob9LX

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 prereason-company-briefing-block-803fcfe8
```

Example prompt: Pull the valuation block for NVDA from PreReason — I want to see the pre-reasoned valuation metrics in markdown format.

## When to prefer this

Choose this endpoint when you need a specific, focused block of a company's financial briefing rather than a full report dump — especially useful when an agent needs to retrieve only the valuation, profitability, or news section to answer a narrow question. Prefer this over generic financial data APIs when you want pre-reasoned, LLM-optimized output that is ready to present or analyze without further transformation. Supports US tickers, CIKs, Japanese securities codes, Korean stock codes, and Indian ISINs.

## Known failure modes

- Invalid or unrecognized ticker/ISIN/CIK returns an error or empty result
- Unsupported block enum value returns a 400-level error
- Company not covered by PreReason returns no data
- Network timeout on data provider side
- Payment failure via x402 protocol blocks access

## How this service works

One block of a company briefing (header, what_changed, situations, against_guidance, numbers, segments, valuation, capital_structure, quality, profitability, news), with the company's name, address, market and the time it was computed. Sold for USA, Japanese, Korean and Indian companies. The whole briefing is $0.35 a call and one block $0.05; the 11 blocks bought one by one come to $0.55. The whole briefing is GET /api/companies/{company}. Today's briefing only: this route takes no ?date=.

## Output

Returns one named block of a company briefing in either markdown (LLM-optimized) or JSON format. Depending on the block requested, the response includes fields such as company name, address, what recently changed, situational signals, guidance deviations, key financial numbers, segment breakdowns, valuation metrics, capital structure details, quality scores, profitability indicators, or latest news items — all pre-reasoned and ready for agent consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "company",
      "block"
     ],
     "properties": {
      "block": {
       "enum": [
        "header",
        "what_changed",
        "situations",
        "against_guidance",
        "numbers",
        "segments",
        "valuation",
        "capital_structure",
        "quality",
        "profitability",
        "news"
       ],
       "type": "string",
       "description": "The block of the company briefing to return."
      },
      "format": {
       "enum": [
        "json",
        "markdown"
       ],
       "type": "string",
       "description": "Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."
      },
      "company": {
       "type": "string",
       "pattern": "^[A-Za-z0-9.-]{1,33}$",
       "description": "The company. A USA ticker or CIK (NVDA), a Japanese securities code (7203), a Korean stock code (005930), an Indian company's ISIN (INE018A01030) or the LEI of a company filing in the UK or of a European company (2138002P5RNKC5W2JZ46). Case does not matter."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-company-briefing-block-803fcfe8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)