{
"openapi": "3.0.1",
"info": {
"title": "SiteVerdict — Global Company Registries (SEC EDGAR, GLEIF LEI)",
"description": "Company profiles, SEC filings, XBRL financials (revenue, net income, assets, shares) and GLEIF corporate trees from official open registries. Search by name, ticker, CIK, LEI or country; LEI-CIK cross-reference; monitor new 8-K/10-K/10-Q filings. No API key needed.",
"version": "1.1",
"x-build-id": "chFePK7B5LblmqXo4"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/siteverdict~siteverdict-company-registries/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-siteverdict-siteverdict-company-registries",
"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/siteverdict~siteverdict-company-registries/runs": {
"post": {
"operationId": "runs-sync-siteverdict-siteverdict-company-registries",
"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/siteverdict~siteverdict-company-registries/run-sync": {
"post": {
"operationId": "run-sync-siteverdict-siteverdict-company-registries",
"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": {
"mode": {
"title": "What do you want to do?",
"enum": [
"lookup",
"monitor",
"full-text-search"
],
"type": "string",
"description": "Lookup: profiles, filings, financials and corporate trees for names, tickers, CIKs or LEIs. Monitor: report new SEC filings (8-K, 10-K, 10-Q...) since the last run for a watch list. Full-text search: find filings that mention a phrase (EDGAR full-text search, 2001+).",
"default": "lookup"
},
"queries": {
"title": "Companies (name, ticker, CIK or LEI)",
"type": "array",
"description": "One per line. Auto-detected: 1-10 digits = SEC CIK (e.g. 320193); 20-character code with valid check digits = LEI (e.g. HWUPKR0MPOU8FGXBT394); short ALL-CAPS = ticker (e.g. AAPL, BRK.B), falling back to a name search; anything else = company name. Force a type with a prefix: cik:, lei:, ticker:, name:.",
"items": {
"type": "string"
}
},
"countries": {
"title": "Countries (for name searches)",
"type": "array",
"description": "Optional ISO 3166-1 alpha-2 codes (US, GB, DE, IN...). Restricts NAME searches to companies whose legal address (GLEIF) or SEC business address is in these countries. Explicit CIKs/LEIs are never filtered.",
"items": {
"type": "string"
}
},
"sources": {
"title": "Registries",
"type": "array",
"description": "sec = US SEC EDGAR (US-listed and SEC-registered companies, including foreign issuers filing 20-F/40-F/6-K). gleif = Global LEI index (millions of legal entities in 200+ jurisdictions).",
"items": {
"type": "string",
"enum": [
"sec",
"gleif"
],
"enumTitles": [
"US SEC EDGAR",
"GLEIF LEI (global)"
]
},
"default": [
"sec",
"gleif"
]
},
"maxResultsPerName": {
"title": "Max companies per name search",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "A name can match several companies; each delivered company is one 'company' event.",
"default": 3
},
"maxCompanies": {
"title": "Max companies per run",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Safety cap across all queries.",
"default": 100
},
"includeFilings": {
"title": "Include SEC filings list",
"type": "boolean",
"description": "Filing rows with form type, dates, 8-K items and links to the document and index on sec.gov. Each row is one 'filing' event.",
"default": true
},
"filingForms": {
"title": "Filing form types",
"type": "array",
"description": "Only these forms (amendments '/A' included automatically). Default: key corporate forms (8-K, 10-K, 10-Q, 20-F, 40-F, 6-K, S-1, S-3, S-4, F-1, DEF 14A, SC 13D/G). Clear the list to get ALL forms, including insider Forms 3/4/5 and 144.",
"items": {
"type": "string"
}
},
"filingsSince": {
"title": "Filings since (YYYY-MM-DD)",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"type": "string",
"description": "Optional. Older filing pages are fetched only when needed."
},
"maxFilingsPerCompany": {
"title": "Max filings per company",
"minimum": 0,
"maximum": 5000,
"type": "integer",
"description": "0 = no filings.",
"default": 20
},
"includeFinancials": {
"title": "Include key financials (XBRL)",
"type": "boolean",
"description": "Revenue, net income, operating income, total assets, liabilities, equity, cash and shares outstanding, with periods, units and the exact XBRL concept, from SEC companyfacts. One 'financials-extract' event per company with data (never charged when the company has no XBRL facts).",
"default": true
},
"financialYears": {
"title": "Fiscal years of history",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many most recent fiscal years to include in the annual[] history.",
"default": 3
},
"financialQuarters": {
"title": "Latest quarters",
"minimum": 0,
"maximum": 20,
"type": "integer",
"description": "3-month periods from 10-Q/6-K. 0 = annual only.",
"default": 4
},
"includeCorporateTree": {
"title": "Include GLEIF corporate tree",
"type": "boolean",
"description": "Direct and ultimate accounting-consolidation parents (or the reported exception, e.g. NATURAL_PERSONS) and direct children. Bundled with the 'company' event - no extra charge.",
"default": true
},
"maxChildren": {
"title": "Max children listed",
"minimum": 0,
"maximum": 2000,
"type": "integer",
"description": "The full child count is always reported.",
"default": 25
},
"includeUltimateChildren": {
"title": "Also list ultimate children (whole group)",
"type": "boolean",
"description": "Also list every entity that GLEIF reports as consolidated into this one at the top of the group (can be large; capped by Max children).",
"default": false
},
"crossReference": {
"title": "Cross-reference LEI <-> CIK",
"type": "boolean",
"description": "Links SEC registrants to their LEI (SEC's own 'lei' field when present = confirmed; otherwise exact legal name + incorporation state + postcode = high confidence). Uncertain matches are listed as candidates, never merged.",
"default": true
},
"monitorForms": {
"title": "Monitor: form types",
"type": "array",
"description": "Forms that count as 'new filings' in monitor mode. Empty = all forms. Default: key corporate forms.",
"items": {
"type": "string"
}
},
"monitorStateName": {
"title": "Monitor: state name",
"type": "string",
"description": "Name of the key-value store that remembers what was already reported. Use different names for different watch lists.",
"default": "default"
},
"monitorLookbackDays": {
"title": "Monitor: first-run look-back (days)",
"minimum": 0,
"maximum": 365,
"type": "integer",
"description": "On the very first run, also report filings from the last N days (0 = baseline only).",
"default": 0
},
"fullTextQuery": {
"title": "Full-text: phrase",
"type": "string",
"description": "Words or \"exact phrase\" (quotes), as in the SEC's own EDGAR full-text search. Add CIKs/tickers above to restrict to those companies."
},
"fullTextForms": {
"title": "Full-text: form types",
"type": "array",
"description": "Optional form types, e.g. 8-K, 10-K. Empty = all forms.",
"items": {
"type": "string"
}
},
"fullTextStartDate": {
"title": "Full-text: filed from (YYYY-MM-DD)",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"type": "string",
"description": "Optional first filing date."
},
"fullTextEndDate": {
"title": "Full-text: filed to (YYYY-MM-DD)",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"type": "string",
"description": "Optional last filing date."
},
"maxFullTextResults": {
"title": "Full-text: max filings",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "EDGAR returns at most 10,000 hits per query.",
"default": 100
},
"secContactEmail": {
"title": "SEC contact e-mail (recommended)",
"type": "string",
"description": "The SEC fair-access policy asks automated tools to declare a contact in the User-Agent header. Your e-mail is sent ONLY to sec.gov in that header, never logged or written to output."
},
"openCorporatesApiToken": {
"title": "OpenCorporates API token (optional, yours)",
"type": "string",
"description": "Adds OpenCorporates company data (status, incorporation date, industry codes incl. NAICS where available) for LEIs that carry an OpenCorporates ID or a UK company number. Commercial service: you must hold an OpenCorporates licence that covers your use (open-data use requires ODbL attribution and share-alike). Stored encrypted, never logged."
},
"useEdgarSearchIndex": {
"title": "Use EDGAR search index for names/tickers",
"type": "boolean",
"description": "Name and ticker look-ups and full-text search use the index behind the SEC's public EDGAR search pages (efts.sec.gov). Turn off to use only the documented data.sec.gov APIs (then give CIKs for SEC data).",
"default": true
},
"secRequestsPerSecond": {
"title": "SEC requests per second",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "SEC fair-access maximum is 10/s. Default 5.",
"default": 5
},
"gleifRequestsPerMinute": {
"title": "GLEIF requests per minute",
"minimum": 1,
"maximum": 60,
"type": "integer",
"description": "Polite request rate for api.gleif.org. Default 50/minute; the actor also backs off automatically on HTTP 429.",
"default": 50
},
"concurrency": {
"title": "Parallel queries",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many queries are processed in parallel. Rate limits are shared, so more parallelism does not exceed the SEC/GLEIF limits.",
"default": 3
},
"sampleMode": {
"title": "Sample mode (recorded data, no charge)",
"type": "boolean",
"description": "Runs offline on real responses recorded on 11 Oct 2026 (Apple, Shell, Tesco). No network calls, nothing charged. Good for testing integrations.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}