{"openapi":"3.1.0","info":{"title":"Quartr (BYOK) API","version":"0.1.0","description":"Quartr (BYOK) lets an AI assistant read your own Quartr data through the Quartr API with a key you supply (Quartr API key). Read-only: 9 tools (list_companies, get_company, list_events, get_event, list_event_types, list_reports, list_slide_decks, list_transcripts, list_document_types). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-quartr.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-quartr/docs"},"termsOfService":"https://connectorbay.com/byok-quartr/terms"},"servers":[{"url":"https://byok-quartr.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-quartr/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 Quartr covers: name, country, tickers with exchanges, ISINs, CIK and OpenFIGI. Filter by ticker, ISIN, CI","description":"List companies Quartr covers: name, country, tickers with exchanges, ISINs, CIK and OpenFIGI. Filter by ticker, ISIN, CIK, country or exchange. Company names cannot be searched. Use for \"What is the Quartr company ID for AAPL\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers, for example AAPL,AMZN.","title":"Tickers"},"isins":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISINs.","title":"Isins"},"ciks":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated SEC CIKs.","title":"Ciks"},"ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated Quartr company IDs.","title":"Ids"},"countries":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISO country codes such as US,SE.","title":"Countries"},"exchanges":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated exchange symbols such as NasdaqGS,NYSE.","title":"Exchanges"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"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/get_company":{"post":{"operationId":"get_company","summary":"Get one company by Quartr company ID. Use for \"Show Quartr company 4742\".","description":"Get one company by Quartr company ID. Use for \"Show Quartr company 4742\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Quartr company ID.","title":"Id","type":"integer"}},"required":["id"],"title":"get_companyArguments","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_events":{"post":{"operationId":"list_events","summary":"List company events (earnings calls, trading updates, conferences, M&A calls) with date, whether confirmed, type and fis","description":"List company events (earnings calls, trading updates, conferences, M&A calls) with date, whether confirmed, type and fiscal period. Filter by company, date range or type. Use for \"When is Apple's next earnings call\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers, for example AAPL,AMZN.","title":"Tickers"},"isins":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISINs.","title":"Isins"},"ciks":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated SEC CIKs.","title":"Ciks"},"company_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated Quartr company IDs.","title":"Company Ids"},"type_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated event type IDs (26 to 29 are quarterly earnings calls).","title":"Type Ids"},"start_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or after this ISO 8601 date, e.g. 2025-01-01T00:00:00Z.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or before this ISO 8601 date.","title":"End Date"},"sort_by":{"anyOf":[{"enum":["id","date"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort field.","title":"Sort By"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_eventsArguments","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_event":{"post":{"operationId":"get_event","summary":"Get one event by ID: company, title, date, type and fiscal period. Use for \"Show Quartr event 128301\".","description":"Get one event by ID: company, title, date, type and fiscal period. Use for \"Show Quartr event 128301\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Quartr event ID.","title":"Id","type":"integer"}},"required":["id"],"title":"get_eventArguments","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_event_types":{"post":{"operationId":"list_event_types","summary":"List event types (for example Q1 to Q4 earnings calls, trading updates) with the parent group. Use for \"What Quartr even","description":"List event types (for example Q1 to Q4 earnings calls, trading updates) with the parent group. Use for \"What Quartr event types exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_event_typesArguments","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_reports":{"post":{"operationId":"list_reports","summary":"List filings and reports (earnings releases, 10-K, 10-Q, 8-K, annual reports) as PDF links with company, event and type.","description":"List filings and reports (earnings releases, 10-K, 10-Q, 8-K, annual reports) as PDF links with company, event and type. Filter by company, date, type or document group. Use for \"List Apple's recent 10-Q filings in Quartr\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers, for example AAPL,AMZN.","title":"Tickers"},"isins":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISINs.","title":"Isins"},"ciks":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated SEC CIKs.","title":"Ciks"},"company_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated Quartr company IDs.","title":"Company Ids"},"event_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated event IDs.","title":"Event Ids"},"type_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated document type IDs (see list_document_types).","title":"Type Ids"},"start_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or after this ISO 8601 date, e.g. 2025-01-01T00:00:00Z.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or before this ISO 8601 date.","title":"End Date"},"document_group_ids":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated groups: 1 earnings release, 2 press release, 3 interim report, 4 annual report, 5 proxy filing, 6 registration filing.","title":"Document Group Ids"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_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/list_slide_decks":{"post":{"operationId":"list_slide_decks","summary":"List slide presentations from events as PDF links with company, event and type. Filter by company, date or type. Use for","description":"List slide presentations from events as PDF links with company, event and type. Filter by company, date or type. Use for \"Which slide decks did Quartr publish for Apple\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers, for example AAPL,AMZN.","title":"Tickers"},"isins":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISINs.","title":"Isins"},"ciks":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated SEC CIKs.","title":"Ciks"},"company_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated Quartr company IDs.","title":"Company Ids"},"event_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated event IDs.","title":"Event Ids"},"type_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated document type IDs (see list_document_types).","title":"Type Ids"},"start_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or after this ISO 8601 date, e.g. 2025-01-01T00:00:00Z.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or before this ISO 8601 date.","title":"End Date"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_slide_decksArguments","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_transcripts":{"post":{"operationId":"list_transcripts","summary":"List earnings call transcripts as JSON file links with company, event and type (15 raw, 22 edited with speakers). Filter","description":"List earnings call transcripts as JSON file links with company, event and type (15 raw, 22 edited with speakers). Filter by company, date or type. Use for \"List Apple's edited transcripts in Quartr\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tickers":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated tickers, for example AAPL,AMZN.","title":"Tickers"},"isins":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated ISINs.","title":"Isins"},"ciks":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated SEC CIKs.","title":"Ciks"},"company_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated Quartr company IDs.","title":"Company Ids"},"event_ids":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated event IDs.","title":"Event Ids"},"type_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated document type IDs (see list_document_types).","title":"Type Ids"},"start_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or after this ISO 8601 date, e.g. 2025-01-01T00:00:00Z.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only records on or before this ISO 8601 date.","title":"End Date"},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_transcriptsArguments","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_document_types":{"post":{"operationId":"list_document_types","summary":"List document types (for example 10-K, 10-Q, earnings release) with form code, category and document group. Use for \"Wha","description":"List document types (for example 10-K, 10-Q, earnings release) with form code, category and document group. Use for \"What document types does Quartr have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 500).","title":"Limit"},"cursor":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pagination.nextCursor from the previous page.","title":"Cursor"},"direction":{"anyOf":[{"enum":["desc","asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction by ID.","title":"Direction"}},"title":"list_document_typesArguments","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}}}}