List Integrations

Overview

Returns a paginated list of integrations for a given node. Use page and per_page query parameters for pagination.

Endpoint: GET /api/v1/integrations

Authentication: Bearer token (JWT) required.

---

Request

Headers

Header	Required	Description
Authorization	Yes	Bearer <your_jwt_token>

Query Parameters

Parameter	Type	Required	Default	Description
node_id	string	Yes	—	Node UUID to filter integrations
page	int	No	1	Page number (1–10000)
per_page	int	No	10	Items per page (1–100, max 100)

---

Response

Success — 200 OK

Field	Type	Description
items	IntegrationResponse[]	List of integrations
page	int	Current page number
per_page	int	Items per page
total	int64	Total number of integrations

Each item in items has:

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

Example Response

{
  "items": [
    {
      "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"
    }
  ],
  "page": 1,
  "per_page": 10,
  "total": 42
}

---

Error Responses

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

---

cURL Example

curl -X GET "https://api.example.com/api/v1/integrations?node_id=550e8400-e29b-41d4-a716-446655440000&page=1&per_page=10" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"