RevKeen Docs
Api reference

List all integrations

Return every integration configured for the authenticated merchant, active or not. Used by the integrations dashboard to render the connection grid. Each entry includes activation state, last sync timestamp, and the provider's display metadata.


Related endpoints

  • POST /integrations/{provider}/activate — Activate integration
  • POST /integrations/{provider}/deactivate — Deactivate integration
  • GET /integrations/{provider} — Get integration status
  • POST /integrations/{provider}/test — Test integration credentials
  • POST /integrations/{provider}/sync — Trigger manual sync
  • PUT /integrations/{provider}/status — Update integration status
  • PUT /integrations/{provider}/sync-toggle — Toggle integration sync
  • PUT /integrations/{provider}/sync-interval — Update sync interval

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

GET
/integrations
x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Response Body

application/json

curl "https://api.revkeen.com/v2/integrations" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "provider": "practicehub",
      "isActive": true,
      "syncEnabled": true,
      "status": "connected",
      "lastSyncAt": "2019-08-24T14:15:22Z",
      "lastSyncError": "string",
      "syncHealth": "healthy",
      "providerState": {
        "consecutiveErrors": 0,
        "lastErrorAt": "string",
        "lastSyncAt": "string",
        "mode": "string"
      },
      "syncInterval": {
        "hasRepeatableJob": true,
        "intervalMs": 0,
        "nextRun": "2019-08-24T14:15:22Z"
      },
      "configuration": {
        "property1": null,
        "property2": null
      },
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ]
}
Empty