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

# Get an integration

`GET /v1/integrations/{integrationRef}`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/integrations/{integrationRef}`
- Auth: API key in header `x-api-key`

Returns the authenticated member or elevated integration projection based on the caller role. Returns 404 when unavailable.

## Path parameters

- `integrationRef` string, required

## Response `200`

- union
  - IntegrationResponseDto
    - `integrationRef` string, required: Public integration reference
    - `priority` integer, required: Integration display priority
    - `name` string, required: Integration name
    - `logoUrl` string, nullable, required: Integration logo URL
    - `description` string, required: Integration description
    - `type` 'BLOCKCHAIN' | 'EXCHANGE' | 'BANK', required: Integration type
    - `chainId` string, nullable, required: Linked chain ID
    - `chain` object, nullable, required: Linked chain testnet classification
      - `isTestnet` boolean, required
    - `exchangeRequiredCredentials` string, nullable, required: Required exchange credential metadata
    - `status` 'ACTIVE' | 'ALPHA' | 'BETA' | 'DISABLED', required: Integration status
    - `isEvm` boolean, required: Whether the integration is EVM-compatible
    - `mode` 'API' | 'FILE_UPLOAD', required: Integration mode
    - `processor` string, nullable, required: Integration processor key
    - `walletsCount` integer, required: Number of wallets using the linked chain
    - `createdAt` string, date-time, required: Creation timestamp (ISO 8601)
    - `updatedAt` string, date-time, required: Last update timestamp (ISO 8601)
  - UserIntegrationCatalogItemDto
    - `integrationRef` string, required: Public integration reference
    - `priority` integer, required: Integration display priority
    - `name` string, required: Integration name
    - `logoUrl` string, nullable, required: Integration logo URL
    - `description` string, required: Integration description
    - `type` 'BLOCKCHAIN' | 'EXCHANGE' | 'BANK', required: Integration type
    - `chainId` string, nullable, required: Linked chain ID
    - `chain` object, nullable, required: Linked chain testnet classification
      - `isTestnet` boolean, required
    - `exchangeRequiredCredentials` string, nullable, required: Required exchange credential metadata
    - `status` 'ACTIVE' | 'ALPHA' | 'BETA' | 'DISABLED', required: Integration status
    - `isEvm` boolean, required: Whether the integration is EVM-compatible
    - `mode` 'API' | 'FILE_UPLOAD', required: Integration mode
    - `processor` string, nullable, required: Integration processor key

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)