{"openapi":"3.1.0","info":{"title":"SEC API Mapping (BYOK) API","version":"0.1.0","description":"SEC API Mapping (BYOK) lets an AI assistant read your own SEC API Mapping data through the SEC API Mapping API with a key you supply (sec-api.io API key (paste it as is)). Read-only: 7 tools (resolve_cik, resolve_ticker, resolve_cusip, resolve_company_name, list_companies_by_exchange, list_companies_by_sector, list_companies_by_industry). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-secapi-mapping.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-secapi-mapping/docs"},"termsOfService":"https://connectorbay.com/byok-secapi-mapping/terms"},"servers":[{"url":"https://byok-secapi-mapping.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-secapi-mapping/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/resolve_cik":{"post":{"operationId":"resolve_cik","summary":"Look up the company record for an SEC Central Index Key (CIK). Returns an array of company records (name, ticker, CIK, C","description":"Look up the company record for an SEC Central Index Key (CIK). Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"Which company has SEC CIK 1318605\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cik":{"description":"SEC Central Index Key, digits without leading zeros, for example 1318605.","maxLength":12,"title":"Cik","type":"string"}},"required":["cik"],"title":"resolve_cikArguments","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/resolve_ticker":{"post":{"operationId":"resolve_ticker","summary":"Look up companies by ticker symbol; by default every ticker containing the text matches, so wrap it as ^IBM$ for an exac","description":"Look up companies by ticker symbol; by default every ticker containing the text matches, so wrap it as ^IBM$ for an exact match. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"Which company trades under the ticker TSLA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol in any case, for example TSLA; use ^TSLA$ for an exact match.","maxLength":20,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"resolve_tickerArguments","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/resolve_cusip":{"post":{"operationId":"resolve_cusip","summary":"Look up the company record for a CUSIP identifier. Returns an array of company records (name, ticker, CIK, CUSIP, exchan","description":"Look up the company record for a CUSIP identifier. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"Which company has CUSIP 88160R101\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cusip":{"description":"CUSIP identifier, for example 88160R101.","maxLength":20,"title":"Cusip","type":"string"}},"required":["cusip"],"title":"resolve_cusipArguments","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/resolve_company_name":{"post":{"operationId":"resolve_company_name","summary":"Look up companies or funds by name, case-insensitive, for example snowflake. Returns an array of company records (name, ","description":"Look up companies or funds by name, case-insensitive, for example snowflake. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"What is the ticker and CIK of Snowflake\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"company_name":{"description":"Company or fund name, for example 'snowflake'.","maxLength":100,"title":"Company Name","type":"string"}},"required":["company_name"],"title":"resolve_company_nameArguments","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/list_companies_by_exchange":{"post":{"operationId":"list_companies_by_exchange","summary":"List companies (listed and delisted) on one exchange; the list can be long, so check isDelisted and use the cap. Returns","description":"List companies (listed and delisted) on one exchange; the list can be long, so check isDelisted and use the cap. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"List NYSE American listed companies\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exchange":{"description":"Exchange code: NYSE, NASDAQ, NYSEMKT, NYSEARCA, OTC, BATS or INDEX.","enum":["NYSE","NASDAQ","NYSEMKT","NYSEARCA","OTC","BATS","INDEX"],"title":"Exchange","type":"string"}},"required":["exchange"],"title":"list_companies_by_exchangeArguments","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/list_companies_by_sector":{"post":{"operationId":"list_companies_by_sector","summary":"List companies (listed and delisted) in one of the 11 sectors; the list can be long. Returns an array of company records","description":"List companies (listed and delisted) in one of the 11 sectors; the list can be long. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"List companies in the Utilities sector\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sector":{"description":"Sector name: Technology, Communication Services, Healthcare, Consumer Cyclical, Consumer Defensive, Basic Materials, Financial Services, Industrials, Real Estate, Energy or Utilities.","enum":["Technology","Communication Services","Healthcare","Consumer Cyclical","Consumer Defensive","Basic Materials","Financial Services","Industrials","Real Estate","Energy","Utilities"],"title":"Sector","type":"string"}},"required":["sector"],"title":"list_companies_by_sectorArguments","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/list_companies_by_industry":{"post":{"operationId":"list_companies_by_industry","summary":"List companies (listed and delisted) in one of 175 industries, for example Software - Application or Banks - Regional. R","description":"List companies (listed and delisted) in one of 175 industries, for example Software - Application or Banks - Regional. Returns an array of company records (name, ticker, CIK, CUSIP, exchange, delisted flag, sector, industry, SIC codes, location). Use for \"List companies in the Banks - Regional industry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"industry":{"description":"Industry name, for example 'Software - Application', 'Banks - Regional' or 'Oil & Gas E&P'.","maxLength":80,"title":"Industry","type":"string"}},"required":["industry"],"title":"list_companies_by_industryArguments","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}}}}