The caller's connected AI apps
const url = 'https://api.tovarifinancial.com/connected-apps';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.tovarifinancial.com/connected-apps \ --header 'Authorization: Bearer <token>'KAN-4118. items: the CALLER’s own live MCP connections (not revoked, not expired), newest first, at most 100, plus serverUrl — the MCP server URL to paste into an AI app. householdItems (KAN-4185): for a household ADMIN, the live connections of every OTHER member of the household (same order and cap), each with member: { userId, displayName }; always [] for any other role. While the MCP server is not armed the answer is 200 { enabled: false, items: [] } (no householdItems, no database work) so clients hide the section. SUBSCRIPTION-EXEMPT. Verification- and policy-gated.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”The connections — or, while the MCP server is not armed, { enabled: false, items: [] }
object
object
object
The app name the member consented to (self-asserted unless verified).
A pre-registered client a Tovari operator verified, as of the connection.
object
Hostname only — never a path, port, query or full URL.
client_metadata: the CIMD client_id URL host; redirect: the redirect URI host; loopback: a native app’s 127.0.0.1 / [::1] / localhost redirect.
KAN-4179. write only when the member allowed changes and has not switched the app back to read-only.
The last successful MCP call, recorded at most every 5 minutes; null when never used.
object
The MCP server URL every connection’s tokens are bound to (https://
object
The app name the member consented to (self-asserted unless verified).
A pre-registered client a Tovari operator verified, as of the connection.
object
Hostname only — never a path, port, query or full URL.
client_metadata: the CIMD client_id URL host; redirect: the redirect URI host; loopback: a native app’s 127.0.0.1 / [::1] / localhost redirect.
KAN-4179. write only when the member allowed changes and has not switched the app back to read-only.
The last successful MCP call, recorded at most every 5 minutes; null when never used.
KAN-4185: other members’ live connections, for a household admin only; [] otherwise.
object
The app name the member consented to (self-asserted unless verified).
A pre-registered client a Tovari operator verified, as of the connection.
object
Hostname only — never a path, port, query or full URL.
client_metadata: the CIMD client_id URL host; redirect: the redirect URI host; loopback: a native app’s 127.0.0.1 / [::1] / localhost redirect.
KAN-4179. write only when the member allowed changes and has not switched the app back to read-only.
The last successful MCP call, recorded at most every 5 minutes; null when never used.
object
The member’s name as the household members list shows it (the trimmed name, else the email).
Example
{ "data": { "enabled": false, "items": [ { "domain": { "kind": "client_metadata" }, "permission": "read" } ] }}Missing, invalid, or expired bearer token
object
Machine-readable error code (AUTH_ERROR_CODES).
Optional field-level validation errors, keyed by field name.
object
Example
{ "errorCode": "INVALID_EMAIL_FORMAT"}Authenticated, but the tenant gate refuses the request until the caller resolves a precondition. errorCode is one of EMAIL_NOT_VERIFIED, POLICY_ACCEPTANCE_REQUIRED, or SUBSCRIPTION_REQUIRED, evaluated in exactly that order (contract term CCR-1: email verification first, then policy acceptance, then subscription — so a subscriber who has merely not re-accepted the current policies always sees POLICY_ACCEPTANCE_REQUIRED). A POLICY_ACCEPTANCE_REQUIRED body additionally carries details.outstanding (the policy versions still to accept) and details.firstAcceptance. The SUBSCRIPTION_REQUIRED arm is INERT unless the server-side BILLING_ENABLED flag is exactly the string true; while it is off, only the first two codes are reachable. Not retryable as sent — resolve the named condition, then resend.
object
Which precondition refused the request. Evaluated in this order (CCR-1); SUBSCRIPTION_REQUIRED is unreachable while BILLING_ENABLED is not exactly true.
object
Active policy versions the user has not yet accepted.
object
True when the user has accepted no policy before — the client renders the new-signup screen rather than the re-acceptance one.
Example
{ "errorCode": "EMAIL_NOT_VERIFIED"}Internal error (no internal detail leaked)
object
Machine-readable error code (AUTH_ERROR_CODES).
Optional field-level validation errors, keyed by field name.
object
Example
{ "errorCode": "INVALID_EMAIL_FORMAT"}Service temporarily unavailable — errorCode is SERVICE_UNAVAILABLE. A TRANSIENT, RETRYABLE condition rather than a defect in the request: a query that exceeded its time budget, a lost or refused database connection, a saturated connection pool, or an outage at an upstream provider the request depends on (the authentication provider, or the bank data provider on a bank-connection operation). The identical request may succeed on retry — back off briefly and, on a write, resend the same X-Idempotency-Key where the operation accepts one.
object
Machine-readable error code (AUTH_ERROR_CODES).
Optional field-level validation errors, keyed by field name.
object
Example
{ "errorCode": "INVALID_EMAIL_FORMAT"}