Pension benefit schedule

Extract expected pension and retiree benefit payments for a requested target year from a selected issuer filing when the rendered source discloses a usable schedule. Supply an issuer, filing year, and target year; preserve the source accession and provenance. An unavailable result is not a zero payment or a complete benefits forecast.

get/v1/filings/pension-benefit-schedule

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/filings/pension-benefit-schedule
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

tickerstring

Issuer ticker, for example AAPL. Use ticker, symbol, or cik to scope issuer-specific filing lookups.

symbolstring

Alias for ticker, for customers coming from market-data APIs. If both ticker and symbol are provided, they must match.

cikstring

Issuer Central Index Key. Use ticker, symbol, or cik to scope issuer-specific filing lookups.

filing_yearinteger required

Calendar year of the filing to inspect; this identifies the disclosure vintage, not the payment year.

target_yearinteger required

Expected pension or retiree benefit-payment year to extract from that filing's disclosed schedule.

formstring

SEC form type. Defaults to 10-K.

accession_numberstring

Optional SEC accession number to inspect directly.

Response

Successful response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.