{"openapi":"3.1.0","info":{"title":"Daloopa (BYOK) API","version":"0.1.0","description":"Daloopa (BYOK) lets an AI assistant read your own Daloopa data through the Daloopa API with a key you supply (Daloopa account email). Read-only: 9 tools (list_companies, list_taxonomy_metrics, get_taxonomy_metric, list_taxonomy_industries, list_taxonomy_sectors, get_company_industry_models, list_company_documents, get_consumption, list_accessed_companies). The BYOK key travels with each request,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-daloopa.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-daloopa/docs"},"termsOfService":"https://connectorbay.com/byok-daloopa/terms"},"servers":[{"url":"https://byok-daloopa.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-daloopa/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/list_companies":{"post":{"operationId":"list_companies","summary":"List companies Daloopa covers: id, name, ticker, industry, sector, ISIN/CIK identifiers and the first and last quarter a","description":"List companies Daloopa covers: id, name, ticker, industry, sector, ISIN/CIK identifiers and the first and last quarter available. Search by name or ticker, or filter by industry. Use for \"Is Apple covered by Daloopa, and for which quarters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Company name or ticker (case-insensitive).","title":"Keyword"},"industry_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only companies in this industry ID.","title":"Industry Id"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_companiesArguments","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_taxonomy_metrics":{"post":{"operationId":"list_taxonomy_metrics","summary":"List standardized taxonomy metrics (KPI definitions) with description, whether global and financial statement sections. ","description":"List standardized taxonomy metrics (KPI definitions) with description, whether global and financial statement sections. Filter by industry, sector or keyword. Use for \"Which Daloopa taxonomy metrics mention revenue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"company_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only metrics this company has.","title":"Company Id"},"industry_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only metrics shared within this industry.","title":"Industry Id"},"sector_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only metrics shared within this sector.","title":"Sector Id"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_taxonomy_metricsArguments","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/get_taxonomy_metric":{"post":{"operationId":"get_taxonomy_metric","summary":"Get one taxonomy metric by ID with the company series that implement it. Use for \"Which companies report Daloopa taxonom","description":"Get one taxonomy metric by ID with the company series that implement it. Use for \"Which companies report Daloopa taxonomy metric 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Taxonomy metric ID.","title":"Id","type":"integer"},"company_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict to one company.","title":"Company Id"},"industry_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict to one industry.","title":"Industry Id"},"sector_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Restrict to one sector.","title":"Sector Id"}},"required":["id"],"title":"get_taxonomy_metricArguments","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_taxonomy_industries":{"post":{"operationId":"list_taxonomy_industries","summary":"List industries with sector and member companies. Filter by sector or company. Use for \"Which companies are in Daloopa i","description":"List industries with sector and member companies. Filter by sector or company. Use for \"Which companies are in Daloopa industry 67\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sector_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only industries in this GICS sector ID.","title":"Sector Id"},"company_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Industry of this company with its peers.","title":"Company Id"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_taxonomy_industriesArguments","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_taxonomy_sectors":{"post":{"operationId":"list_taxonomy_sectors","summary":"List sectors with their industries. Use for \"What sectors does Daloopa classify companies into\".","description":"List sectors with their industries. Use for \"What sectors does Daloopa classify companies into\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_taxonomy_sectorsArguments","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/get_company_industry_models":{"post":{"operationId":"get_company_industry_models","summary":"List the industry model mapping for each company: ISIN and the industry models with description and update time. Use for","description":"List the industry model mapping for each company: ISIN and the industry models with description and update time. Use for \"Which industry models does Daloopa have per company\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_company_industry_modelsArguments","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_company_documents":{"post":{"operationId":"list_company_documents","summary":"List filing and document metadata for one company: filing date, type (10-K, 10-Q, 8-K, news, transcript), quarter and ID","description":"List filing and document metadata for one company: filing date, type (10-K, 10-Q, 8-K, news, transcript), quarter and ID. Filter by type and quarter. Use for \"List Apple's 10-Q filings in Daloopa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"company_id":{"description":"Daloopa company ID.","minimum":1,"title":"Company Id","type":"integer"},"filing_type":{"anyOf":[{"enum":["10-K","10-Q","8-K","News Article","Other","Transcript"],"type":"string"},{"type":"null"}],"default":null,"description":"Filing type.","title":"Filing Type"},"has_fundamentals":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only documents with extracted fundamentals.","title":"Has Fundamentals"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"required":["company_id"],"title":"list_company_documentsArguments","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/get_consumption":{"post":{"operationId":"get_consumption","summary":"Show your monthly datapoint allowance and how much you have used in a date window (default this month). Use for \"How muc","description":"Show your monthly datapoint allowance and how much you have used in a date window (default this month). Use for \"How much of my Daloopa monthly limit have I used\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_at":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Window start YYYY-MM-DD (default first of this month).","title":"Start At"},"end_at":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Window end YYYY-MM-DD (default now).","title":"End At"}},"title":"get_consumptionArguments","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_accessed_companies":{"post":{"operationId":"list_accessed_companies","summary":"List companies you have previously pulled data for, with the first time each was accessed. Use for \"Which companies has ","description":"List companies you have previously pulled data for, with the first time each was accessed. Use for \"Which companies has my Daloopa key pulled data for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_accessed_companiesArguments","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}}}}