{"openapi":"3.1.0","info":{"title":"Economic Accounting Setup (BYOK) API","version":"0.1.0","description":"Economic Accounting Setup (BYOK) lets an AI assistant read your own Economic Accounting Setup data through the Economic Accounting Setup API with a key you supply (app secret token). Read-only: 12 tools (list_currencies, list_payment_terms, list_payment_types, list_journals, list_vat_accounts, list_vat_zones, list_vat_types, list_units, list_layouts, list_accounting_year_periods,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-e-conomic-accounting-setup.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-e-conomic-accounting-setup/docs"},"termsOfService":"https://connectorbay.com/byok-e-conomic-accounting-setup/terms"},"servers":[{"url":"https://byok-e-conomic-accounting-setup.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-e-conomic-accounting-setup/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_currencies":{"post":{"operationId":"list_currencies","summary":"List the currencies available on the agreement with ISO code, numeric code and name. Use for \"Which currencies can I use","description":"List the currencies available on the agreement with ISO code, numeric code and name. Use for \"Which currencies can I use in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_currenciesArguments","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_payment_terms":{"post":{"operationId":"list_payment_terms","summary":"List payment terms with number, name, type, days of credit and description. Use for \"What payment terms are set up in e-","description":"List payment terms with number, name, type, days of credit and description. Use for \"What payment terms are set up in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_payment_termsArguments","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_payment_types":{"post":{"operationId":"list_payment_types","summary":"List payment types with number and name. Use for \"Which payment types does e-conomic have\".","description":"List payment types with number and name. Use for \"Which payment types does e-conomic have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_payment_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_journals":{"post":{"operationId":"list_journals","summary":"List journals with number, name and the default contra accounts for customer payments, finance vouchers and supplier pay","description":"List journals with number, name and the default contra accounts for customer payments, finance vouchers and supplier payments. Filterable by journalNumber and name. Use for \"Which journals does my e-conomic agreement have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional filter such as name$like:*cash* (operators $eq, $ne, $like, $and, $or).","title":"Filter"},"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_journalsArguments","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_vat_accounts":{"post":{"operationId":"list_vat_accounts","summary":"List VAT accounts with code, name, rate percentage, barred flag, the account and contra account and the VAT type. Use fo","description":"List VAT accounts with code, name, rate percentage, barred flag, the account and contra account and the VAT type. Use for \"What VAT codes and rates does e-conomic have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_vat_accountsArguments","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_vat_zones":{"post":{"operationId":"list_vat_zones","summary":"List VAT zones with number, name and whether they can be used for customers and suppliers. Use for \"Which VAT zones exis","description":"List VAT zones with number, name and whether they can be used for customers and suppliers. Use for \"Which VAT zones exist in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_vat_zonesArguments","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_vat_types":{"post":{"operationId":"list_vat_types","summary":"List VAT types with number and name. Use for \"What VAT types are defined in e-conomic\".","description":"List VAT types with number and name. Use for \"What VAT types are defined in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_vat_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_units":{"post":{"operationId":"list_units","summary":"List the units of measure with number and name. Use for \"Which units of measure are available in e-conomic\".","description":"List the units of measure with number and name. Use for \"Which units of measure are available in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_unitsArguments","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_layouts":{"post":{"operationId":"list_layouts","summary":"List invoice layouts with number, name and deleted flag. Use for \"Which invoice layouts exist in e-conomic\".","description":"List invoice layouts with number, name and deleted flag. Use for \"Which invoice layouts exist in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"title":"list_layoutsArguments","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_accounting_year_periods":{"post":{"operationId":"list_accounting_year_periods","summary":"List the periods of one accounting year with period number, dates and closed flag. Filterable by fromDate, periodNumber ","description":"List the periods of one accounting year with period number, dates and closed flag. Filterable by fromDate, periodNumber and toDate. Use for \"Which periods of accounting year 2026 are closed in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"accounting_year":{"description":"Accounting year identifier from list_accounting_years, for example 2026.","maxLength":200,"title":"Accounting Year","type":"string"},"filter":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional filter on fromDate, periodNumber or toDate, for example periodNumber$gte:3.","title":"Filter"},"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"required":["accounting_year"],"title":"list_accounting_year_periodsArguments","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_accounting_year_totals":{"post":{"operationId":"get_accounting_year_totals","summary":"Get the total entry amount in base currency per account for one accounting year (account number, dates and total). Use f","description":"Get the total entry amount in base currency per account for one accounting year (account number, dates and total). Use for \"What are the account totals for accounting year 2026 in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"accounting_year":{"description":"Accounting year identifier from list_accounting_years, for example 2026.","maxLength":200,"title":"Accounting Year","type":"string"},"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"required":["accounting_year"],"title":"get_accounting_year_totalsArguments","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_period_totals":{"post":{"operationId":"get_period_totals","summary":"Get the total entry amount in base currency per account for one period of an accounting year. Use for \"What were the acc","description":"Get the total entry amount in base currency per account for one period of an accounting year. Use for \"What were the account totals for period 3 of 2026 in e-conomic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"accounting_year":{"description":"Accounting year identifier, for example 2026.","maxLength":200,"title":"Accounting Year","type":"string"},"period":{"description":"Period number inside the year, for example 3.","maxLength":200,"title":"Period","type":"string"},"pagesize":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 1000, default 100).","title":"Pagesize"},"skippages":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many pages of pagesize results to skip, for paging (0 is the first page).","title":"Skippages"}},"required":["accounting_year","period"],"title":"get_period_totalsArguments","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}}}}