{
  "openapi": "3.0.1",
  "info": {
    "title": "US Company Filings & Financials: 10-K, 10-Q, 8-K, XBRL Facts",
    "description": "Get the filing history, profile and key financial facts (revenue, net income, assets, EPS, cash flow) of US public companies by ticker or CIK, from SEC EDGAR public data. Official endpoints, your own declared contact. Pay per company; failures are free. Not affiliated with the U.S. SEC.",
    "version": "0.1",
    "x-build-id": "F3PkBRhglG9MKb1ln"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tan-solutions~company-filings/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tan-solutions-company-filings",
        "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/tan-solutions~company-filings/runs": {
      "post": {
        "operationId": "runs-sync-tan-solutions-company-filings",
        "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/tan-solutions~company-filings/run-sync": {
      "post": {
        "operationId": "run-sync-tan-solutions-company-filings",
        "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",
        "required": [
          "companies"
        ],
        "properties": {
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "Tickers (AAPL, BRK.B) or SEC CIK numbers (320193). Duplicates are removed. Up to 1,000 per run.",
            "default": [
              "AAPL",
              "MSFT",
              "320193"
            ],
            "items": {
              "type": "string"
            }
          },
          "companyName": {
            "title": "Your company or name (required by the SEC)",
            "minLength": 2,
            "maxLength": 100,
            "type": "string",
            "description": "The SEC fair-access policy asks automated tools to declare a company name and a contact email in the User-Agent header. This is yours; it is sent only to the SEC and never stored in the results."
          },
          "contactEmail": {
            "title": "Your contact email (required by the SEC)",
            "maxLength": 254,
            "type": "string",
            "description": "An address where the SEC can reach you about your traffic. Sent only to the SEC in the User-Agent header; never stored in the results and masked in the log."
          },
          "forms": {
            "title": "Form types",
            "type": "array",
            "description": "Only these forms, e.g. 10-K, 10-Q, 8-K, DEF 14A, 20-F. Empty = all forms. Insider forms (3, 4, 5, 144, 13D, 13G) need the insider option below.",
            "items": {
              "type": "string"
            }
          },
          "includeAmendments": {
            "title": "Include amendments (10-K/A for 10-K)",
            "type": "boolean",
            "description": "When a form type is listed, also return its amendments.",
            "default": true
          },
          "filedAfter": {
            "title": "Filed on or after",
            "type": "string",
            "description": "Date YYYY-MM-DD. Older filing pages are read only when this window reaches back to them."
          },
          "filedBefore": {
            "title": "Filed on or before",
            "type": "string",
            "description": "Date YYYY-MM-DD."
          },
          "maxFilingsPerCompany": {
            "title": "Max filings per company",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Newest first. 0 = profile and facts only.",
            "default": 20
          },
          "includeFacts": {
            "title": "Key financial facts",
            "type": "boolean",
            "description": "Latest annual revenue, gross profit, operating income, net income, EPS, assets, liabilities, equity, cash, operating cash flow and shares outstanding, from the company's XBRL data.",
            "default": true
          },
          "extraConcepts": {
            "title": "Extra XBRL concepts",
            "type": "array",
            "description": "More facts as taxonomy:Concept, e.g. us-gaap:ResearchAndDevelopmentExpense. Up to 30.",
            "items": {
              "type": "string"
            }
          },
          "includeInsiderFilings": {
            "title": "Include insider filings and individual filers",
            "type": "boolean",
            "description": "Off by default: Forms 3/4/5, 144 and Schedules 13D/13G, and CIKs that belong to individual people. Personal addresses are never returned.",
            "default": false
          },
          "maxCompanies": {
            "title": "Max companies",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "A safety cap for this run. Companies past it are listed in the run SUMMARY and not charged.",
            "default": 100
          },
          "requestsPerSecond": {
            "title": "Requests per second",
            "minimum": 0.5,
            "maximum": 5,
            "type": "number",
            "description": "The SEC allows 10 per second per user across all machines; Apify IPs are shared, so this Actor uses 2 by default and never more than 5.",
            "default": 2
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}