{"openapi":"3.1.0","info":{"title":"SEC API Corporate Events (BYOK) API","version":"0.1.0","description":"SEC API Corporate Events (BYOK) lets an AI assistant read your own SEC API Corporate Events data through the SEC API Corporate Events API with a key you supply (sec-api.io API key (paste it as is)). Read-only: 8 tools (search_subsidiaries, search_audit_fees, search_financial_statement_audit_reports, search_icfr_audit_reports, search_auditor_changes, search_restatements,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-secapi-events.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-secapi-events/docs"},"termsOfService":"https://connectorbay.com/byok-secapi-events/terms"},"servers":[{"url":"https://byok-secapi-events.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-secapi-events/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_subsidiaries":{"post":{"operationId":"search_subsidiaries","summary":"Search the subsidiaries listed in company annual reports (Exhibit 21) by ticker or CIK; each filing returns the subsidia","description":"Search the subsidiaries listed in company annual reports (Exhibit 21) by ticker or CIK; each filing returns the subsidiary names and jurisdictions. Use for \"Which subsidiaries does Tesla list and where are they incorporated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query in field:value form, for example ticker:TSLA or cik:(37996 1318605).","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_subsidiariesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_audit_fees":{"post":{"operationId":"search_audit_fees","summary":"Search audit, audit-related, tax and other fees paid to auditors as disclosed in proxy statements, by company and period","description":"Search audit, audit-related, tax and other fees paid to auditors as disclosed in proxy statements, by company and period. Use for \"How much did Tesla pay its auditor in audit fees in recent proxy statements\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query, for example cik:1318605 or filedAt:[2019-01-01 TO 2022-12-31].","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_audit_feesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_financial_statement_audit_reports":{"post":{"operationId":"search_financial_statement_audit_reports","summary":"Search auditor reports on financial statements: opinion type, going-concern flag, critical audit matters and auditor fir","description":"Search auditor reports on financial statements: opinion type, going-concern flag, critical audit matters and auditor firm. Use for \"Which recent audit reports carried a going concern warning\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene search over the records in field:value form, for example report.goingConcernFlag:true; combine with AND, OR, NOT.","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_financial_statement_audit_reportsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_icfr_audit_reports":{"post":{"operationId":"search_icfr_audit_reports","summary":"Search auditor reports on internal control over financial reporting: framework, opinion, effectiveness and material weak","description":"Search auditor reports on internal control over financial reporting: framework, opinion, effectiveness and material weaknesses. Use for \"Which companies reported material weaknesses in internal control this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene search over the records in field:value form, for example report.materialWeaknessIdentified:true; combine with AND, OR, NOT.","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_icfr_audit_reportsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_auditor_changes":{"post":{"operationId":"search_auditor_changes","summary":"Search Form 8-K Item 4.01 filings about changes of the company's auditor: former and new accountant, reason and any disa","description":"Search Form 8-K Item 4.01 filings about changes of the company's auditor: former and new accountant, reason and any disagreements. Use for \"Which companies changed their auditor in 2022\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query on 8-K fields, for example item4_01:* AND filedAt:[2022-01-01 TO 2022-12-31].","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_auditor_changesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_restatements":{"post":{"operationId":"search_restatements","summary":"Search Form 8-K Item 4.02 filings announcing that earlier financial statements should no longer be relied on: reasons, a","description":"Search Form 8-K Item 4.02 filings announcing that earlier financial statements should no longer be relied on: reasons, affected periods and impact. Use for \"Which companies announced financial restatements this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query on 8-K fields, for example item4_02:* AND filedAt:[2025-01-01 TO 2025-12-31].","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_restatementsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_cybersecurity_incidents":{"post":{"operationId":"search_cybersecurity_incidents","summary":"Search Form 8-K Item 1.05 disclosures of material cybersecurity incidents: attack types, data affected, impact and respo","description":"Search Form 8-K Item 1.05 disclosures of material cybersecurity incidents: attack types, data affected, impact and response. Use for \"Which companies disclosed ransomware incidents in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query, for example incident.attackTypes:ransomware AND disclosure.filingRole:initial AND filing.filedAt:[2025-01-01 TO 2025-12-31].","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_cybersecurity_incidentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_shareholder_meetings":{"post":{"operationId":"search_shareholder_meetings","summary":"Search the calendar of shareholder meetings taken from proxy statements: meeting date, type, format, record date and vot","description":"Search the calendar of shareholder meetings taken from proxy statements: meeting date, type, format, record date and voting deadlines. Use for \"Which annual shareholder meetings are scheduled in May\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Lucene query, for example meetingDate:[2026-05-01 TO 2026-05-31] or entities.ticker:TSLA.","maxLength":500,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many matches to skip, for paging (0 to 10000); step by size to get the next page.","title":"Offset"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 50).","title":"Size"}},"required":["query"],"title":"search_shareholder_meetingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}