Overview
Connected Services
GET /api/v1/agent/services
Overview
The Connected Services endpoint returns a list of services and integrations currently available to the authenticated project.
Connected services represent the data sources that Statement can access when processing queries through the Agent API. These may include payment platforms, accounting systems, CRM tools, databases, analytics platforms, and other supported integrations.
The endpoint only returns high-level service metadata and does not expose any sensitive configuration details.
For security reasons, credentials, authentication tokens, connection settings, API keys, and other service-specific configuration fields are never included in the response.
Request
No request body is required.
Example Request
curl -X GET https://api.statement.com/api/v1/agent/services \
-H "Authorization: Bearer <YOUR_API_KEY>"
Response
Example Response
{
"services": [
{
"id": "stripe",
"name": "Stripe",
"last_sync": "2026-01-02T03:04:05"
}
],
"count": 1
}
Response Fields
Top-Level Fields
| Field | Type | Description |
|---|---|---|
services | array | List of connected services available to the authenticated project. |
count | integer | Total number of services returned in the response. |
Service Object
Each service entry contains the following fields:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier used internally to reference the service. This value may also be used with features such as agent_scope. |
name | string | Human-readable service name. |
last_sync | string (ISO 8601) | Timestamp of the most recent successful synchronization with the service, when available. |
Example Response
A project with multiple connected integrations might return:
{
"services": [
{
"id": "stripe",
"name": "Stripe",
"last_sync": "2026-01-02T03:04:05"
},
{
"id": "xero",
"name": "Xero",
"last_sync": "2026-01-02T04:15:30"
},
{
"id": "hubspot",
"name": "HubSpot",
"last_sync": "2026-01-02T05:10:12"
}
],
"count": 3
}
Common Use Cases
- Discover which integrations are available to a project.
- Display connected services within an application dashboard.
- Determine valid values for the
agent_scopeparameter. - Verify integration connectivity and synchronization status.
- Build service management and monitoring interfaces.
Data Privacy
This endpoint only exposes service metadata required for discovery and routing.
The following information is never returned:
- API keys
- OAuth tokens
- Service credentials
- Connection settings
- Account identifiers
- Internal configuration fields
- Synchronization payloads or raw service data
Notes
- Results are scoped to the authenticated project.
- Only services registered and available through the Statement backend are returned.
- The
last_syncfield is provided in ISO 8601 format. - A service appearing in this response does not expose its underlying data; it only indicates that the integration is available for agent queries.
- Service identifiers returned by this endpoint can be used with the
agent_scopefield when making agent query requests.