Sign in
External: Providers

Get Providers

Get providers with their configuration and metadata.

Query params:

  • enabled_only: Filter to only enabled providers (default: False, returns all)
  • cloud_only: Filter to only providers with cloud OAuth API (default: False)

Returns full provider details including name, icon_url, has_cloud_api, is_enabled.

get/api/v1/oauth/providers

Query parameters

enabled_onlyboolean

Return only enabled providers

Return only enabled providers

cloud_onlyboolean

Return only cloud (OAuth) providers

Return only cloud (OAuth) providers

Response

Successful Response

providerstring required

Provider identifier (e.g., 'apple', 'garmin')

namestring required

Display name (e.g., 'Apple Health', 'Garmin')

has_cloud_apiboolean required

Whether provider uses cloud OAuth API

is_enabledboolean required

Whether provider is enabled by admin

icon_urlstring required

Relative URL to provider icon (e.g., '/static/provider-icons/garmin.svg'). Resolve against the API base URL.

live_sync_mode'pull' | 'webhook'
live_sync_configurableboolean

Whether the admin can switch live_sync_mode for this provider.

data_granularity'daily' | 'hourly' | 'raw'

How finely a provider's 24/7 data is stored.

DAILY — one aggregated value per day (server-side rollup). HOURLY — one aggregated value per hour (server-side rollup). RAW — every individual reading (no aggregation), where the provider supports it.

Changes

Changed in 1 of the 9 revisions of this API.1

  • e8a9270a1ee11See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog