List your teams, their projects and your role

get/v1/me/teams

Requires an API key

Every team you belong to with your team role, team permissions and the projects (tenants) your role reaches, each with its scopes; plus pending invites to your confirmed email and your Ivora staff roles, if any. Staff reach every team through their platform roles, which are not listed as memberships.

Returns · 200

dataarray of MembershipRequired
Child attributes
- idstringRequired
  The team ID.
- namestringRequired
- roleenumRequired
  Team role: owner (everything, the team's card and members; never limited to projects), admin (every project, its creation and renaming, the team's billing and the members, never an owner), developer (tenant-admin project access: stations, billing, tokens, webhooks, the project's API keys), operator (read access plus stations:control), viewer (read access, webhooks included) or billing (the team's billing pages and card, no project scope).
  One of owner, admin, developer, operator, viewer, billing
- all_projectsbooleanRequired
  False when you are limited to the projects listed.
- permissionsarray of stringRequired
  Team permissions: members:manage (invite, change and remove members), billing:manage (the team's billing: card, invoices and usage), keys:manage (the projects' API keys), projects:manage (create and rename projects).
- projectsarray of ProjectAccessRequired
  Child attributes
  - idintegerRequired
    The project's tenant ID, used in /v1/tenants/{tenant_id} routes.
  - namestring | null
    The tenant's name in the charging core; null when the core did not answer.
  - scopesarray of stringRequired
    The project scopes your role gives you here.
invitesarray of InviteRecordRequired
Pending, unexpired invites addressed to your confirmed email; accept with POST /v1/me/invites/{invite_id}/accept.
Child attributes
- idstringRequired
- team_idstringRequired
- team_namestring | null
- emailstringRequired
- roleenumRequired
  One of owner, admin, developer, operator, viewer, billing
- projectsarray of integer | nullRequired
  Tenant IDs of the team's projects the member is limited to; null for every project, now and later. Owners and admins are never limited.
- statusenumRequired
  One of pending, accepted, declined, revoked
- expiredbooleanRequired
  A pending invite past expires_at can no longer be accepted; invite again.
- invited_bystringRequired
- created_atstringRequired
- expires_atstringRequired
- responded_atstring | null
platform_rolesarray of stringRequired
Ivora staff roles (admin, platform-admin, platform-support): every team, outside these memberships.

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

GET /v1/me/teams

curl --fail-with-body "https://api.ivoracharge.com/v1/me/teams" \
  -H "Authorization: Bearer $IVORA_API_KEY"

Response · 200

{
  "data": [
    {
      "id": "id_0123456789abcdef",
      "name": "bay-01",
      "role": "owner",
      "all_projects": false,
      "permissions": [
        "string"
      ],
      "projects": [
        {
          "id": 1,
          "name": "bay-01",
          "scopes": [
            null
          ]
        }
      ]
    }
  ],
  "invites": [
    {
      "id": "id_0123456789abcdef",
      "team_id": "team_0123456789abcdef",
      "team_name": "string",
      "email": "developer@example.com",
      "role": "owner",
      "projects": [
        1
      ],
      "status": "pending",
      "expired": false,
      "invited_by": "string",
      "created_at": "2026-09-30T17:00:00Z",
      "expires_at": "2026-09-30T17:00:00Z",
      "responded_at": "2026-09-30T17:00:00Z"
    }
  ],
  "platform_roles": [
    "string"
  ]
}

Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.