{ "openapi": "3.0.1", "info": { "title": "Public Company Earnings Dates and Reporting Window Finder", "description": "Finds when a public company reports. Give it a domain, ticker, ISIN, LEI or CIK and get back fiscal year end, reporting cadence, next reporting date, days to event, and the open and close of the outreach window, as one flat row per company built for Clay. Timing rows cover US companies only.", "version": "0.0", "x-build-id": "jMwU7aGFFOb3B5sB8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~public-company-reporting-window-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-public-company-reporting-window-finder", "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/mambalabs~public-company-reporting-window-finder/runs": { "post": { "operationId": "runs-sync-mambalabs-public-company-reporting-window-finder", "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/mambalabs~public-company-reporting-window-finder/run-sync": { "post": { "operationId": "run-sync-mambalabs-public-company-reporting-window-finder", "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": "Mode", "enum": [ "resolve", "qualify", "timing", "universe", "season" ], "type": "string", "description": "resolve returns identity and venue. qualify adds a listed status verdict. timing returns fiscal year end, reporting cadence, the next obligated event and your outreach window. universe builds a company list from filters. season returns reporting load per week or month.", "default": "resolve" }, "company_domain": { "title": "Company Domain", "type": "string", "description": "A single bare domain, e.g. stripe.com. The Clay column shape. Used by resolve, qualify and timing." }, "company_domains": { "title": "Company Domains (batch)", "type": "array", "description": "Many domains at once. Used by resolve, qualify and timing.", "items": { "type": "string" } }, "tickers": { "title": "Tickers", "type": "array", "description": "Exchange tickers, e.g. NWLG. Matched against the primary ticker and every venue listing.", "items": { "type": "string" } }, "isins": { "title": "ISINs", "type": "array", "description": "12 character ISINs.", "items": { "type": "string" } }, "leis": { "title": "LEIs", "type": "array", "description": "20 character Legal Entity Identifiers.", "items": { "type": "string" } }, "ciks": { "title": "SEC CIKs", "type": "array", "description": "SEC Central Index Keys, with or without leading zeros.", "items": { "type": "string" } }, "company_names": { "title": "Company Names", "type": "array", "description": "Legal or trading names. Matched on a normalized name. Former names are not available: the alias table carries tickers and ISINs only.", "items": { "type": "string" } }, "operating_companies_only": { "title": "Operating Companies Only", "enum": [ "false", "true" ], "type": "string", "description": "Drop funds, trusts and other non operating entities. Sent as a string for Clay compatibility.", "default": "false" }, "exclude_blank_checks": { "title": "Exclude Blank Check Shells", "enum": [ "false", "true" ], "type": "string", "description": "Drop pre deal SPACs. Separate from the operating company filter: a blank check shell is flagged as an operating company and passes every ordinary firmographic filter.", "default": "false" }, "listed_only": { "title": "Keep Only Listed Companies", "enum": [ "false", "true" ], "type": "string", "description": "qualify mode. Keep only rows proven to be publicly listed.", "default": "false" }, "suppress_listed": { "title": "Suppress Listed Companies", "enum": [ "false", "true" ], "type": "string", "description": "qualify mode. Remove companies proven to be publicly listed, for anyone selling only into private companies. It removes what we can prove is listed; it does not warrant that the remainder is private.", "default": "false" }, "assume_unmatched_is_private": { "title": "Treat an Unmatched Company as Private", "enum": [ "false", "true" ], "type": "string", "description": "qualify mode. By default an unmatched company returns is_listed null, because a non match may mean the company is private OR that we do not hold its domain. Set true to opt into reading a non match as private, which sets is_listed false.", "default": "false" }, "foreign_private_issuer": { "title": "Foreign Private Issuer", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Filter on foreign private issuer status.", "default": "any" }, "us_registrant_only": { "title": "US SEC Registrants Only", "enum": [ "false", "true" ], "type": "string", "description": "Keep only companies carrying an SEC CIK.", "default": "false" }, "exchange_codes": { "title": "Exchange Codes (MIC)", "type": "array", "description": "ISO 10383 MICs. 18 venues are covered.", "items": { "type": "string" } }, "country_codes": { "title": "Country Codes", "type": "array", "description": "ISO 3166-1 alpha-2, e.g. US, GB, FR.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Shorthand for a set of venues and countries: us, uk, eu. Widens an explicit exchange or country filter rather than replacing it.", "items": { "type": "string" } }, "sectors": { "title": "Sectors", "type": "array", "description": "SEC SIC descriptions, e.g. Pharmaceutical Preparations. Populated on roughly 65 percent of the publishable universe.", "items": { "type": "string" } }, "security_types": { "title": "Security Types", "type": "array", "description": "ordinary_shares, depositary_receipt, preferred_shares.", "items": { "type": "string" } }, "public_float_bands": { "title": "Public Float Bands", "type": "array", "description": "micro, small, mid, large, mega, unknown. Size runs on public float because market capitalization is not populated anywhere in this dataset.", "items": { "type": "string" } }, "fiscal_year_end_months": { "title": "Fiscal Year End Months", "type": "array", "description": "Integers 1 to 12. Fiscal year end is effectively a United States field in this dataset.", "items": { "type": "string" } }, "exclude_december_fiscal_year_end": { "title": "Exclude December Fiscal Year End", "enum": [ "false", "true" ], "type": "string", "description": "Keep only companies whose fiscal year ends in a month other than December, the accounts whose budget cycle is out of phase with a calendar quarter.", "default": "false" }, "cadences": { "title": "Reporting Cadences", "type": "array", "description": "quarterly, semiannual, annual, unknown.", "items": { "type": "string" } }, "min_cadence_confidence": { "title": "Minimum Cadence Confidence", "type": "string", "description": "0 to 1. Rows whose cadence confidence falls below this return a null timing block with a stated reason rather than a guess. Quarterly cadence averages 0.94, annual 0.40, semiannual 0.21.", "default": "0" }, "event_types": { "title": "Event Types", "type": "array", "description": "full_year_results, half_year_results, quarterly_results, trading_update, annual_report_publication, sustainability_report_publication, agm, proxy_filing, capital_markets_day.", "items": { "type": "string" } }, "window_lead_days": { "title": "Outreach Window Lead Days", "type": "string", "description": "How many days before the event the outreach window opens. Default 70.", "default": "70" }, "window_lag_days": { "title": "Outreach Window Lag Days", "type": "string", "description": "How many days before the event the outreach window closes. Default 42. Must be less than the lead.", "default": "42" }, "window_statuses": { "title": "Window Statuses", "type": "array", "description": "Keep only rows in these window states: open, not_yet, closed_passed, no_event.", "items": { "type": "string" } }, "max_days_to_event": { "title": "Maximum Days to Event", "type": "string", "description": "Drop rows whose next event is further away than this. A cost control." }, "include_constrained_period": { "title": "Include the Constrained Announcement Period", "enum": [ "true", "false" ], "type": "string", "description": "Emit the period in which a listed company is constrained in what it can announce, derived from the same window numbers. Useful for campaign and announcement timing.", "default": "true" }, "season_group_by": { "title": "Season Group By", "enum": [ "week", "month" ], "type": "string", "description": "season mode. Bucket size.", "default": "week" }, "season_split_by": { "title": "Season Split By", "enum": [ "none", "sector", "country", "exchange_code" ], "type": "string", "description": "season mode. Optional second dimension.", "default": "none" }, "season_from": { "title": "Season From", "type": "string", "description": "season mode. ISO date. Defaults to today." }, "season_to": { "title": "Season To", "type": "string", "description": "season mode. ISO date. Defaults to 180 days from today." }, "min_provenance_confidence": { "title": "Minimum Source Confidence", "enum": [ "any", "high" ], "type": "string", "description": "Set to high to exclude rows whose source terms were never read.", "default": "any" }, "exclude_name_only_matches": { "title": "Exclude Name Only Identity Matches", "enum": [ "false", "true" ], "type": "string", "description": "Drop rows whose identity link rests on a name and country agreeing rather than on an identifier. Use this wherever a wrong identity link matters.", "default": "false" }, "exclude_share_alike": { "title": "Exclude Share Alike Sourced Rows", "enum": [ "false", "true" ], "type": "string", "description": "Drop rows derived from CC BY-SA sources, whose share alike condition may not suit a closed product.", "default": "false" }, "limit": { "title": "Limit", "type": "string", "description": "Maximum rows for universe and season. Truncation is always reported, never silent.", "default": "1000" }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } }, "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 } } } } } } } } } }