---
title: "Get an integration"
method: GET
path: "/v1/integrations/{id}"
tags: ["integrations"]
---

# Get an integration

`GET /v1/integrations/{id}`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/integrations/{id}`
- Auth: HTTP bearer

Get one integration: its site, tools, MCP status, MCP URL and server name.

You can read a public integration or one your team's list holds. An integration key reaches only its own.

## Path parameters

- `id` string, required

## Response `200`

The integration

- Integration
  - `id` string, required: an integration ID: int_ and 32 lowercase hex digits
  - `name` string, required: The site's everyday name, such as Instacart
  - `description` string, required: What the site is, in a sentence
  - `site_url` string, nullable, required: The site's https origin; null for an offline integration
  - `visibility` 'public' | 'private', required
  - `owned_by_me` boolean, required: Whether it holds a tool you created or own
  - `added` boolean, required: Whether your account added it to My integrations
  - `built` boolean, required: Whether it holds a tool you or your team created
  - `status` 'ready' | 'disabled' | 'not_hosted', required: Its MCP: ready with mcp_url, disabled, or not_hosted where this deployment hosts none. Its tools run through the Pomerado MCP and REST in every state.
  - `mcp_url` string, nullable, required: Its MCP endpoint while ready; connect with GET /v1/connect
  - `keyless_mcp_url` string, nullable, required: Its MCP's URL for use without signing in; null unless the integration is public and ready
  - `mcp_server_name` string, nullable, required: Its MCP's name in client configs, such as instacart
  - `icon_url` string, nullable, required: Its site's icon, a PNG on the API host; null when it has none. Fetch it with the same Authorization: Bearer <API key> header as the API, from a key that can read integrations (tools:read); a key for one integration fetches only its icon. Without credentials it answers 401, and it answers 404 while the site has no captured icon. The URL changes whenever the icon may, so an icon fetched from it can be kept
  - `tools` object[], required
    - `id` string, required: a tool ID: tool_ and 32 lowercase hex digits
    - `name` string, required
    - `description` string, required
    - `effect` 'read' | 'write', required
    - `login_required` boolean, required
  - `created_at` string, required: a string to be decoded into a Date
  - `updated_at` string, required: a string to be decoded into a Date

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `404`: not_found
- `500`: internal_error
- `503`: temporarily_unavailable

---

[API](https://skmtc.dev/pomerado/apis/pomerado-api.md) · [All operations](https://skmtc.dev/pomerado/apis/pomerado-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pomerado/apis/pomerado-api/revisions/48dac2a3143e?raw)