Overview

Service Details Jun 12, 2026

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

FieldTypeDescription
servicesarrayList of connected services available to the authenticated project.
countintegerTotal number of services returned in the response.

Service Object

Each service entry contains the following fields:

FieldTypeDescription
idstringUnique identifier used internally to reference the service. This value may also be used with features such as agent_scope.
namestringHuman-readable service name.
last_syncstring (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_scope parameter.
  • 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_sync field 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_scope field when making agent query requests.

Tags

Try Statement Today

Get early updates, and product notes.

Get early access