# AnswerPool Shares Outstanding

> AnswerPool Shares Outstanding is a paid API for AI agents from answerpool.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns deduplicated common shares outstanding time series from SEC XBRL filings for a given company, by period.

## Facts

- Endpoint: GET https://answerpool.io/v1/sec/xbrl/shares
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/answerpool-shares-outstanding-7354e315
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SwfYCW26YbpxbtLMUYKMB

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 answerpool-shares-outstanding-7354e315
```

Example prompt: Pull the common shares outstanding history for Apple — their ticker is AAPL — so I can check dilution trends and do per-share math across quarters.

## When to prefer this

Use this endpoint when you need a clean, deduplicated time series of common shares outstanding sourced directly from SEC XBRL, without parsing companyfacts JSON or cover pages yourself. Prefer it over raw EDGAR APIs when you want period-labeled, form-attributed share counts ready for per-share or dilution calculations. Best for financial modeling, EPS computation, or equity research workflows that need historical share counts by fiscal quarter or year.

## Known failure modes

- Missing ticker and CIK — at least one must be provided or the request fails
- Invalid CIK format — must be numeric and up to 10 digits
- Unknown ticker — not mapped to a SEC filer, returns error or empty
- Company has no XBRL shares outstanding data filed — returns empty points array
- Rate limit or payment failure via x402 — call rejected before data is returned

## How this service works

AnswerPool turns SEC EDGAR, the Federal Register, USAspending, NIH, BLS and OpenAlex into structured JSON answers that AI agents and developers fetch in one call. 69 endpoints free, no account; derived analyses $0.02–$0.05 per call by card credits or USDC (x402). MCP server, full provenance.

## Output

A JSON object containing the company's CIK, an as-of timestamp, and an array of fact point rows each with end date, share count value, fiscal period (fp), fiscal year (fy), form type (e.g. 10-Q), and filed date. Also includes the source URL pointing to the underlying SEC EDGAR XBRL concept data and a disclaimer.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "title": "TickerCikIn",
     "properties": {
      "cik": {
       "anyOf": [
        {
         "type": "string",
         "pattern": "^\\d{1,10}$",
         "maxLength": 10
        },
        {
         "type": "null"
        }
       ],
       "title": "Cik",
       "default": null,
       "description": "SEC CIK, 1-10 digits, zero padding optional (e.g. 320193 or 0000320193). Provide exactly one of cik or ticker."
      },
      "ticker": {
       "anyOf": [
        {
         "type": "string",
         "maxLength": 12
        },
        {
         "type": "null"
        }
       ],
       "title": "Ticker",
       "default": null,
       "description": "US exchange ticker, case-insensitive (e.g. AAPL); resolved through the EDGAR ticker map, and an unknown ticker returns 422. Provide exactly one of ticker or cik."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "as_of": "2026-08-31T14:00:00Z",
  "points": [
   {
    "fp": "Q3",
    "fy": 2026,
    "end": "2026-06-28",
    "form": "10-Q",
    "filed": "2026-08-01",
    "value": 15000000000
   }
  ],
  "source": "https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/CommonStockSharesOutstanding.json"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/answerpool-shares-outstanding-7354e315/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from answerpool.io](https://www.zero.xyz/host/answerpool.io/llms.txt)