{
  "openapi": "3.0.1",
  "info": {
    "title": "SEC EDGAR Financials API: Revenue, EPS & Fundamentals",
    "description": "Normalized annual or quarterly fundamentals from SEC EDGAR XBRL filings (10-K, 10-Q, 20-F, 40-F) by ticker or CIK: revenue, net income, EPS, assets, debt, cash flow, plus optional recent filings index. One row per company. Not affiliated with the SEC.",
    "version": "0.1",
    "x-build-id": "f6UcKafhRi5xVjkXw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aeriontsai~us-company-financials/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aeriontsai-us-company-financials",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/aeriontsai~us-company-financials/runs": {
      "post": {
        "operationId": "runs-sync-aeriontsai-us-company-financials",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/aeriontsai~us-company-financials/run-sync": {
      "post": {
        "operationId": "run-sync-aeriontsai-us-company-financials",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "ciks": {
            "title": "CIK numbers",
            "maxItems": 100,
            "type": "array",
            "description": "Central Index Keys of the companies (1 to 10 digits, leading zeros optional, e.g. 320193 or 0000320193). Up to 100 CIKs and tickers together per run.",
            "items": {
              "type": "string"
            }
          },
          "tickers": {
            "title": "Ticker symbols",
            "maxItems": 100,
            "type": "array",
            "description": "Optional: ticker symbols. They are mapped to CIKs with the company ticker list published by the U.S. Securities and Exchange Commission (one extra request per run). Tickers that are not in that list are skipped and not charged.",
            "items": {
              "type": "string"
            }
          },
          "statements": {
            "title": "Statements",
            "minItems": 1,
            "maxItems": 3,
            "type": "array",
            "description": "Which key figures to include: income statement, balance sheet, cash flow statement.",
            "items": {
              "type": "string",
              "enum": [
                "income",
                "balance",
                "cashflow"
              ],
              "enumTitles": [
                "Income statement",
                "Balance sheet",
                "Cash flow statement"
              ]
            },
            "default": [
              "income",
              "balance",
              "cashflow"
            ]
          },
          "periodType": {
            "title": "Period type",
            "enum": [
              "annual",
              "quarterly"
            ],
            "type": "string",
            "description": "Annual = fiscal years (10-K, 20-F, 40-F). Quarterly = 3-month quarters as reported (10-Q). A fourth quarter is not calculated; quarterly cash-flow figures are empty when the company reports only year-to-date totals.",
            "default": "annual"
          },
          "periods": {
            "title": "Number of periods",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many of the most recent periods to return per company.",
            "default": 4
          },
          "includeFilingsIndex": {
            "title": "Include recent filings index",
            "type": "boolean",
            "description": "Also output one row per recent filing (forms 10-K, 10-Q, 8-K and their amendments only). Each filing row is a separate charged event.",
            "default": false
          },
          "filingForms": {
            "title": "Filing forms",
            "type": "array",
            "description": "Forms to list in the filings index. Only these forms are supported.",
            "items": {
              "type": "string",
              "enum": [
                "10-K",
                "10-K/A",
                "10-Q",
                "10-Q/A",
                "8-K",
                "8-K/A"
              ]
            },
            "default": [
              "10-K",
              "10-K/A",
              "10-Q",
              "10-Q/A",
              "8-K",
              "8-K/A"
            ]
          },
          "maxFilingsPerCompany": {
            "title": "Maximum filing rows per company",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Newest filings first. Only the most recent filings block of the source is read.",
            "default": 20
          },
          "maxItems": {
            "title": "Maximum rows",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many output rows in total (company rows plus filing rows). Every row is charged, so this also caps your cost.",
            "default": 100
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}