{"openapi":"3.1.0","info":{"title":"Lenco (BYOK) API","version":"0.1.0","description":"Lenco (BYOK) lets an AI assistant read your own Lenco data through the Lenco API with a key you supply (Lenco API token (the token can also move money; this connector only reads)). Read-only: 7 tools (list_accounts, get_account, get_account_balance, list_transactions, get_transaction, get_transaction_by_reference, list_banks). The BYOK key travels with each request, is used for that one call only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-lenco.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-lenco/docs"},"termsOfService":"https://connectorbay.com/byok-lenco/terms"},"servers":[{"url":"https://byok-lenco.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-lenco/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_accounts":{"post":{"operationId":"list_accounts","summary":"List your Lenco bank accounts with name, type, status, currency, available and current balance. Account numbers are not ","description":"List your Lenco bank accounts with name, type, status, currency, available and current balance. Account numbers are not returned. Use for \"What are my Lenco account balances\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_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/get_account":{"post":{"operationId":"get_account","summary":"Get one Lenco account by id: name, type, status, currency and balances. Use for \"Show Lenco account 056ffebf-812a-433a-8","description":"Get one Lenco account by id: name, type, status, currency and balances. Use for \"Show Lenco account 056ffebf-812a-433a-83a0-9c67cd8c089c\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Lenco account id (36-character UUID), from list_accounts.","maxLength":36,"title":"Account Id","type":"string"}},"required":["account_id"],"title":"get_accountArguments","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_account_balance":{"post":{"operationId":"get_account_balance","summary":"Get the available and current balance of one Lenco account. Use for \"How much can I spend from Lenco account 056ffebf-81","description":"Get the available and current balance of one Lenco account. Use for \"How much can I spend from Lenco account 056ffebf-812a-433a-83a0-9c67cd8c089c\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Lenco account id (36-character UUID), from list_accounts.","maxLength":36,"title":"Account Id","type":"string"}},"required":["account_id"],"title":"get_account_balanceArguments","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_transactions":{"post":{"operationId":"list_transactions","summary":"List transactions on your Lenco accounts (credits and debits) with status, amount, fee, narration and times, filtered by","description":"List transactions on your Lenco accounts (credits and debits) with status, amount, fee, narration and times, filtered by status, type, dates or search text. The counterparty details of each transaction are included as returned. Use for \"Show my failed Lenco debits this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"status":{"anyOf":[{"enum":["pending","successful","failed","declined"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"type":{"anyOf":[{"enum":["credit","debit","transfer"],"type":"string"},{"type":"null"}],"default":null,"description":"credit, debit, or transfer (bank transfer debits only).","title":"Type"},"start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Earliest initiated or completed date, YYYY-MM-DD.","title":"Start"},"end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Latest initiated or completed date, YYYY-MM-DD.","title":"End"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search text.","title":"Search"}},"title":"list_transactionsArguments","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_transaction":{"post":{"operationId":"get_transaction","summary":"Get one Lenco transaction by id: type, status, amount, fee, narration, times, your client reference and failure reason. ","description":"Get one Lenco transaction by id: type, status, amount, fee, narration, times, your client reference and failure reason. Use for \"What happened to Lenco transaction 46ce8b2d-457c-4d0f-a3bb-5fbfd0a230fa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transaction_id":{"description":"Transaction id (UUID).","maxLength":200,"title":"Transaction Id","type":"string"}},"required":["transaction_id"],"title":"get_transactionArguments","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_transaction_by_reference":{"post":{"operationId":"get_transaction_by_reference","summary":"Find a Lenco transaction by the client reference your system supplied when creating it. Use for \"Find the Lenco transact","description":"Find a Lenco transaction by the client reference your system supplied when creating it. Use for \"Find the Lenco transaction with reference ref-1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"reference":{"description":"Client reference supplied when the transaction was created.","maxLength":200,"title":"Reference","type":"string"}},"required":["reference"],"title":"get_transaction_by_referenceArguments","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_banks":{"post":{"operationId":"list_banks","summary":"List the banks and financial institutions Lenco supports, with their codes. Use for \"Which banks does Lenco support\".","description":"List the banks and financial institutions Lenco supports, with their codes. Use for \"Which banks does Lenco support\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_banksArguments","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}}}}