Companies Retrieve Annual Facts

Last 30 days

Uptime

100%

Response time

489 ms typical, 840 ms slowest 5%

Last check

3 h ago

Next check

any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://api.mekler.ai/v1/finance/companies/retrieve-annual-facts" \
  -H "content-type: application/json" \
  -d '{"cik":"320193","quote_mode":"fast","years":1}'

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.mekler.ai%2Fv1%2Ffinance%2Fcompanies%2Fretrieve-annual-facts
const res = await pay("https://api.mekler.ai/v1/finance/companies/retrieve-annual-facts", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"cik":"320193","quote_mode":"fast","years":1}),
});
console.log(await res.json());

Example input

{
  "cik": "320193",
  "quote_mode": "fast",
  "years": 1
}

Example output

{
  "cik": "0000320193",
  "comparisons": [],
  "coverage": {
    "complete": true,
    "reported_fields": 6,
    "requested_fields": 6,
    "requested_years": 1,
    "returned_years": 1
  },
  "limitations": [
    "US-GAAP standard whole-entity USD facts in annual 10-K/10-K/A only."
  ],
  "retrieved_at": "2026-10-05T00:00:00Z",
  "selection_policy": "latest-annual-filed-per-field-v1",
  "sources": {
    "companyfacts": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json",
    "submissions": "https://data.sec.gov/submissions/CIK0000320193.json"
  },
  "status": "ok",
  "years": [
    {
      "fields": {
        "assets": {
          "accession": "0000320193-25-000079",
          "filed": "2025-10-31",
          "form": "10-K",
          "period_end": "2025-09-27",
          "period_start": null,
          "status": "reported",
          "tag": "Assets",
          "taxonomy": "us-gaap",
          "unit": "USD",
          "value": 359241000000
        },
        "cash": {
          "status": "reported",
          "value": 35934000000
        },
        "liabilities": {
          "status": "reported",
          "value": 285508000000
        },
        "net_income": {
          "status": "reported",
          "value": 112010000000
        },
        "operating_cash_flow": {
          "status": "reported",
          "value": 111482000000
        },
        "revenue": {
          "status": "reported",
          "value": 416161000000
        }
      },
      "fiscal_year": 2025,
      "period_end": "2025-09-27"
    }
  ]
}

Security scan

• No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks