API ReferenceServices & Catalog
Get Catalog Service
Get full details for a catalog service including OpenAPI spec and agent-friendly summary.
Get Catalog Service
Returns complete details for a service in the catalog, including its OpenAPI specification, parsed endpoints, and an agent-friendly summary.
Authentication
Requires X-API-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Service UUID |
Request
curl http://localhost:4000/v1/catalog/SERVICE_ID \
-H "X-API-Key: ak_your_key"Response (200)
{
"id": "service-uuid",
"name": "Weather API",
"description": "Real-time weather data",
"base_url": "https://api.weather.example.com",
"pricing_model": "per_call",
"price_per_call_usd": 0.005,
"category": "data",
"total_calls": 1500,
"openapi_spec": {
"openapi": "3.0.0",
"info": {"title": "Weather API", "version": "1.0"},
"paths": { "..." : "..." }
},
"agent_summary": "Weather API provides real-time weather data. Endpoints: GET /forecast - Get weather forecast (requires city query param).",
"endpoints": [
{
"method": "GET",
"path": "/forecast",
"summary": "Get weather forecast",
"parameters": [{"name": "city", "in": "query", "required": true}]
}
],
"created_at": "2026-03-26T12:00:00.000Z"
}Response fields
| Field | Type | Description |
|---|---|---|
openapi_spec | object | Full OpenAPI specification |
agent_summary | string | Plain-text summary for AI agents |
endpoints | array | Parsed list of available endpoints |
Errors
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | Service not found or not active |