Log inTalk to us
Developer tools

List an app's installs across the team's projects

get/v1/teams/{team_id}/apps/{app_id}/installs
Requires an API key

Revoked installs are included, for a project-limited developer only in their projects, and only when the app is active in none outside them.

Path parameters

  • team_idstringRequired
    Pattern ^team_[0-9a-f]{32}$
  • app_idstringRequired
    Pattern ^app_[0-9a-f]{32}$

Returns · 200

  • dataarray of InstallRecordRequired
    Child attributes
    • idstringRequired
    • app_idstringRequired
    • app_namestring | null
    • tenant_idintegerRequired
    • scopesarray of stringRequired
      What the app holds in this project: its consented scopes, never more than the app requests.
    • consent_revisionintegerRequired
    • rate_limit_per_minuteintegerRequired
    • statusenumRequired
      One of active, revoked
    • installed_bystringRequired
    • installed_atstringRequired
    • updated_atstringRequired
    • revoked_atstring | nullRequired
    • revoked_bystring | nullRequired
    • revoked_reasonstring | nullRequired
      uninstalled or app_archived.
    • staff_reasonstring | null
      Set when Ivora staff installed the app on the project's request: why. Null for an install by the project's own team.
GET /v1/teams/{team_id}/apps/{app_id}/installs
curl --fail-with-body "https://api.ivoracharge.com/v1/teams/team_0123456789abcdef0123456789abcdef/apps/app_0123456789abcdef0123456789abcdef/installs" \
  -H "Authorization: Bearer $IVORA_API_KEY"
Response · 200JSON
{
  "data": [
    {
      "id": "id_0123456789abcdef",
      "app_id": "app_0123456789abcdef",
      "app_name": "string",
      "tenant_id": 1042,
      "scopes": [
        "string"
      ],
      "consent_revision": 1,
      "rate_limit_per_minute": 1,
      "status": "active",
      "installed_by": "string",
      "installed_at": "2026-09-30T17:00:00Z",
      "updated_at": "2026-09-30T17:00:00Z",
      "revoked_at": "2026-09-30T17:00:00Z",
      "revoked_by": "string",
      "revoked_reason": "string",
      "staff_reason": "string"
    }
  ]
}
Requires an approved production API keyProduction access starts with a request, a short meeting with Ivora and a card on file, after which Ivora staff grant your account access. How to request access
Try itproduction · api.ivoracharge.com

Paste a production api key (iv_live_…). Create keys in Developer tools. The key stays in this page's memory, is sent only to https://api.ivoracharge.com and clears when you reload. Test keys are refused.