Get Integration by ID

Overview

Returns a single integration by UUID. The secret is never returned — it is only shown once when the integration is created.

Endpoint: GET /api/v1/integrations/{id}

Authentication: Bearer token (JWT) required.

---

Request

Headers

Header	Required	Description
Authorization	Yes	Bearer <your_jwt_token>

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Integration UUID

---

Response

Success — 200 OK

Field	Type	Description
id	string	Integration UUID
node_id	string	Node UUID
name	string	Integration name
api_key	string	API key (e.g. apex_abc123...)
permissions	string[]	Permission list
expires_at	string	Expiration date (or null)
created_at	string	Creation timestamp

Note: The secret field is never returned for existing integrations.

Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "node_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Production API",
  "api_key": "apex_abc123xyz456",
  "permissions": ["payments.read", "payments.create"],
  "expires_at": "2026-12-31T23:59:59Z",
  "created_at": "2025-02-14T10:00:00Z"
}

---

Error Responses

Status	Description
400	Invalid request (validation error)
401	Unauthorized (missing or invalid token)
404	Integration not found
500	Internal server error

---

cURL Example

curl -X GET https://api.example.com/api/v1/integrations/550e8400-e29b-41d4-a716-446655440001 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"