---
title: "Get this tenant's registered Odoo connection (no secrets)."
method: GET
path: "/api/v1/tenant/odoo-connection"
tags: ["tenant"]
---

# Get this tenant's registered Odoo connection (no secrets).

`GET /api/v1/tenant/odoo-connection`

## Request

- Base URL: `https://api.prosp.cc`
- URL: `https://api.prosp.cc/api/v1/tenant/odoo-connection`
- Auth: OAuth 2 (client credentials, token URL `https://prosp-mcp-641053169627.auth.eu-central-1.amazoncognito.com/oauth2/token`, scopes: `mcp/execute`)

## Response `200`

The registered connection.

- TenantOdooConnection: Your registered Odoo connection, without any secrets. `validated_at` and `message` are present only on a successful submit response. The `odoo_api_key` and any other credential material are never included in this response.
  - `customer_id` string, required: Your tenant identifier (derived from the access token).
  - `odoo_url` string, required: The Odoo base URL leads are written to.
  - `odoo_db` string, required: Your Odoo database name — the API authentication parameter identifying which database on the Odoo server leads are synced into. Leads are written through Odoo's JSON-RPC API; no direct database access is used.
  - `odoo_uid` integer, required: The Odoo user id the stored API key belongs to.
  - `status` string, required: Connection status (e.g. `active`).
  - `stage_id` integer, nullable: The configured Odoo CRM stage id for new leads, or null if unset.
  - `team_id` integer, nullable: The configured Odoo sales-team id for new leads, or null if unset.
  - `user_id` integer, nullable: The configured Odoo salesperson user id for new leads, or null if unset.
  - `enrichment_stage_id` integer, nullable: The configured Odoo CRM stage id for leads awaiting enrichment, or null if unset.
  - `lead_type` 'lead' | 'opportunity': Whether records are created as leads or opportunities.
  - `validated_at` string, date-time: When the connection was last successfully validated (present only on a submit response).
  - `message` string: Human-readable outcome of the submit (present only on a submit response).

## Other responses

- `401`: Missing/invalid/expired Bearer token.
- `404`: No Odoo connection registered for this tenant.
- `429`: Rate limit exceeded (100 requests / 60s per customer).
- `503`: Tenant-registry unavailable — either not configured on this deployment (`error: registry_unavailable`) or the backend is temporarily unreachable (`error: registry_degraded`, `retryable: true`, with a `Retry-After` header — safe to retry with backoff).

---

[API](https://skmtc.dev/prosp/apis/prosp-discovery-api.md) · [All operations](https://skmtc.dev/prosp/apis/prosp-discovery-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prosp/apis/prosp-discovery-api/revisions/1f2e0c55da22?raw)