find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/tiingo:tiingo-corporate-actions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Tiingo Corporate Actions API
  version: 1.0.0
  description: 'Tiingo''s REST API for financial market data: end-of-day equity prices, IEX intraday, BOATS overnight equity data, consolidated equity realtime snapshots, crypto, crypto yield, forex, fundamentals, mutual fund and ETF fees, corporate actions, curated news, and asset search.'
  termsOfService: https://www.tiingo.com/about/terms
  contact:
    name: Tiingo Support
    url: https://www.tiingo.com/support
    email: support@tiingo.com
  x-apievangelist:
    generated: '2026-07-22'
    method: generated
    source: https://apimedia.tiingo.com/dist/src_app_api_documentation_documentation_module_ts-es2015.f5eea3d64917e26bb724.js
servers:
- url: https://api.tiingo.com
security:
- apiTokenHeader: []
- apiTokenQuery: []
tags:
- name: Corporate Actions
paths:
  /tiingo/corporate-actions/{ticker}/distribution-yield:
    get:
      operationId: getDistributionYield
      summary: Get trailing distribution yield for a ticker
      tags:
      - Corporate Actions
      externalDocs:
        url: https://www.tiingo.com/documentation/corporate-actions/dividends
      parameters:
      - name: ticker
        in: path
        required: true
        description: Ticker related to the asset you would like yield data for.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DistributionYield'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /tiingo/corporate-actions/{ticker}/distributions:
    get:
      operationId: getTickerDistributions
      summary: Get dividend distributions for a ticker
      tags:
      - Corporate Actions
      externalDocs:
        url: https://www.tiingo.com/documentation/corporate-actions/dividends
      parameters:
      - name: ticker
        in: path
        required: true
        description: Ticker related to the asset you would like distribution data for.
        schema:
          type: string
      - name: startExDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date >= on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: endExDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date <= on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Distribution'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /tiingo/corporate-actions/distributions:
    get:
      operationId: getBulkDistributions
      summary: Get dividend distributions across all tickers for an ex-date
      tags:
      - Corporate Actions
      externalDocs:
        url: https://www.tiingo.com/documentation/corporate-actions/dividends
      parameters:
      - name: exDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Distribution'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /tiingo/corporate-actions/{ticker}/splits:
    get:
      operationId: getTickerSplits
      summary: Get split corporate actions for a ticker
      tags:
      - Corporate Actions
      externalDocs:
        url: https://www.tiingo.com/documentation/corporate-actions/splits
      parameters:
      - name: ticker
        in: path
        required: true
        description: Ticker related to the asset you would like distribution data for.
        schema:
          type: string
      - name: startExDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date >= on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      - name: endExDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date <= on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Split'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /tiingo/corporate-actions/splits:
    get:
      operationId: getBulkSplits
      summary: Get split corporate actions across all tickers for an ex-date
      tags:
      - Corporate Actions
      externalDocs:
        url: https://www.tiingo.com/documentation/corporate-actions/splits
      parameters:
      - name: exDate
        in: query
        required: false
        description: This filter limits distributions that have an ex-date on the date passed. Parameter must be in YYYY-MM-DD format.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Split'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  responses:
    TooManyRequests:
      description: Usage limit exceeded. Tiingo limits by hourly requests (reset every hour), daily requests (reset at midnight EST), and monthly bandwidth (reset the first of every month at midnight EST); there is no per-minute or per-second rate limit.
    Unauthorized:
      description: Missing or invalid API token.
  schemas:
    Distribution:
      type: object
      properties:
        permaTicker:
          type: string
          description: The Tiingo permaticker.
        ticker:
          type: string
          description: Ticker related to the asset.
        exDate:
          type: string
          format: date-time
          description: The ex-Date of the distribution. In the Tiingo EOD Endpoints, this is the date where "divCash" will be non-zero. This is also the date used for dividend price adjustments.
        paymentDate:
          type: string
          format: date-time
          description: The payment date of the distribution.
        recordDate:
          type: string
          format: date-time
          description: The record date of the distribution.
        declarationDate:
          type: string
          format: date-time
          description: The declaration date of the distribution.
        distribution:
          type: number
          description: The total distribution for the given date.
        distributionFreqency:
          type: string
          description: 'The frequency that''s associated with this distribution. For example "q" means quarterly, meaning this is a declared quarterly distribution. The full list of codes is available here: w : Weekly bm : Bimonthly m : Monthly tm : Trimesterly q : Quarterly sa : Semiannually a : Annually ir : Irregular f : Final u : Unspecified c : Cancelled'
    DistributionYield:
      type: object
      properties:
        date:
          type: string
          format: date-time
          description: Date associated with the yield.
        trailingDiv1Y:
          type: string
          description: The trailing distribution yield for the asset based on the previous 1 year of distributions.
    Split:
      type: object
      properties:
        permaTicker:
          type: string
          description: The Tiingo permaticker.
        ticker:
          type: string
          description: Ticker related to the asset.
        exDate:
          type: string
          format: date-time
          description: The ex-Date of the split. In the Tiingo EOD Endpoints, this is the date where "splitFactor" will not be 1.0. This is also the date used for split adjustments.
        splitFrom:
          type: number
          description: The prior split ratio.
        splitTo:
          type: number
          description: The new split ratio, i.e. how many shares of "splitTo" are given for each share of "splitFrom".
        splitFactor:
          type: number
          description: 'The ratio of splitTo from splitFrom . In other words: splitFactor = splitTo/splitFrom This ratio is helpful in calculating split price adjustments.'
        splitStatus:
          type: string
          description: 'A code representing the status of split a : Active c : Cancelled'
  securitySchemes:
    apiTokenHeader:
      type: apiKey
      in: header
      name: Authorization
      description: 'Pass your API token in the Authorization header as: Authorization: Token <your-token>.'
    apiTokenQuery:
      type: apiKey
      in: query
      name: token
      description: Pass your API token directly in the request URL via the token query parameter.
externalDocs:
  description: Tiingo API documentation
  url: https://www.tiingo.com/documentation/general/overview