---
title: Account Management | Runware Docs
url: https://runware.ai/docs/platform/account-management
description: Retrieve account details, team information, API keys, and usage statistics for your organization using the account management API.
relatedDocuments:
  - https://runware.ai/docs/platform/authentication
  - https://runware.ai/docs/platform/rate-limits
---
## Introduction

The `accountManagement` task provides **programmatic access to your organization's account information**, including team members, API keys, balance, and usage statistics. This is useful for building internal dashboards or monitoring tools that integrate with your Runware account.

Currently, only the `getDetails` operation is available. Additional operations for managing settings, team members, and API keys will be added in future updates.

## Request

Our API always accepts an array of objects as input, where each object represents a **specific task to be performed**. The structure of the object varies depending on the type of the task. For this section, we will focus on the parameters related to the **account management task**.

The following JSON snippet shows the basic structure of a request object.

```json
[
  {
    "taskType": "accountManagement",
    "taskUUID": "f4dd3dfe-955f-49d5-a785-7e3b633d6e7a",
    "operation": "getDetails"
  }
]
```

---

### [taskType](#request-tasktype)

- **Type**: `const:accountManagement`
- **Required**: true
- **Value**: `accountManagement`

The type of task to perform.

### [taskUUID](#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [operation](#request-operation)

- **Type**: `string`
- **Required**: true

The specific account management operation to perform.

**Allowed values**: `getDetails`

## Response

Results will be delivered in the format below.

```json
{
  "data": [
    {
      "taskType": "accountManagement",
      "taskUUID": "f4dd3dfe-955f-49d5-a785-7e3b633d6e7a",
      "operation": "getDetails",
      "organizationUUID": "a6379343-9ff2-46a0-996b-e4a7b3057c88",
      "organizationName": "Acme Corporation",
      "AIRSource": "acme",
      "balance": 2450.75,
      "team": [
        {
          "name": "John Smith",
          "email": "john.smith@acme.com",
          "roles": [
            "Owner"
          ],
          "joinedAt": "2024-01-15T10:30:00Z"
        },
        {
          "name": "Emily Johnson",
          "email": "emily.johnson@acme.com",
          "roles": [
            "Admin"
          ],
          "joinedAt": "2024-03-22T14:20:00Z"
        },
        {
          "name": "Michael Chen",
          "email": "michael.chen@acme.com",
          "roles": [
            "Developer"
          ],
          "joinedAt": "2024-05-10T09:15:00Z"
        }
      ],
      "apiKeys": [
        {
          "name": "Production API Key",
          "apiKey": "YHluz4gk5KU4ZZWr****************",
          "description": "Main production environment key",
          "createdAt": "2024-01-20T11:00:00Z",
          "enabled": true,
          "requests": 15420,
          "lastUsedAt": "2025-10-12T08:45:30Z"
        },
        {
          "name": "Development API Key",
          "apiKey": "fhVbIFjuDlSwZJgY****************",
          "description": "Testing and development",
          "createdAt": "2024-02-05T16:30:00Z",
          "enabled": true,
          "requests": 3287,
          "lastUsedAt": "2025-10-11T15:22:18Z"
        }
      ],
      "usage": {
        "total": {
          "credits": 48920.50,
          "requests": 2540318
        },
        "today": {
          "credits": 35.80,
          "requests": 1850
        },
        "last7Days": {
          "credits": 412.25,
          "requests": 21400
        },
        "last30Days": {
          "credits": 1685.90,
          "requests": 87560
        }
      }
    }
  ]
}
```

---

### [taskType](#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `accountManagement`

Identifier for the type of task being performed

### [taskUUID](#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [organizationName](#response-organizationname)

- **Type**: `string`
- **Required**: true

The name of the organization.

### [organizationUUID](#response-organizationuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

Unique identifier for the organization.

### [balance](#response-balance)

- **Path**: `balance.amount`
- **Type**: `object (3 properties)`
- **Required**: true

Current account balance and currency.

#### [amount](#response-balance-amount)

- **Path**: `balance.amount`
- **Type**: `float`
- **Required**: true

Current balance amount.

#### [freeBalance](#response-balance-freebalance)

- **Path**: `balance.freeBalance`
- **Type**: `float`

Available free credit balance.

#### [currency](#response-balance-currency)

- **Path**: `balance.currency`
- **Type**: `string`
- **Required**: true

Currency code (e.g., USD).

### [team](#response-team)

- **Path**: `team.name`
- **Type**: `array of objects (4 properties)`
- **Required**: true

List of team members.

#### [name](#response-team-name)

- **Path**: `team.name`
- **Type**: `string`
- **Required**: true

Full name of the team member.

#### [email](#response-team-email)

- **Path**: `team.email`
- **Type**: `string`
- **Required**: true
- **Format**: `EMAIL`

Email address of the team member.

#### [roles](#response-team-roles)

- **Path**: `team.roles`
- **Type**: `array of strings`
- **Required**: true

Roles assigned to the team member.

#### [joinedAt](#response-team-joinedat)

- **Path**: `team.joinedAt`
- **Type**: `string`
- **Format**: `DATE-TIME`

Date and time when the member joined.

### [apiKeys](#response-apikeys)

- **Path**: `apiKeys.apiKey`
- **Type**: `array of objects (7 properties)`
- **Required**: true

List of API keys associated with the account.

#### [apiKey](#response-apikeys-apikey)

- **Path**: `apiKeys.apiKey`
- **Type**: `string`
- **Required**: true

The API key string (partially masked).

#### [name](#response-apikeys-name)

- **Path**: `apiKeys.name`
- **Type**: `string`
- **Required**: true

Name or label for the API key.

#### [description](#response-apikeys-description)

- **Path**: `apiKeys.description`
- **Type**: `string`

Description of the API key.

#### [enabled](#response-apikeys-enabled)

- **Path**: `apiKeys.enabled`
- **Type**: `boolean`
- **Required**: true

Whether the API key is active.

#### [createdAt](#response-apikeys-createdat)

- **Path**: `apiKeys.createdAt`
- **Type**: `string`
- **Required**: true
- **Format**: `DATE-TIME`

Date and time when the key was created.

#### [lastUsedAt](#response-apikeys-lastusedat)

- **Path**: `apiKeys.lastUsedAt`
- **Type**: `string`
- **Format**: `DATE-TIME`

Date and time when the key was last used.

#### [requests](#response-apikeys-requests)

- **Path**: `apiKeys.requests`
- **Type**: `integer`

Total number of requests made with this key.

### [usage](#response-usage)

- **Path**: `usage.today`
- **Type**: `object (12 properties)`
- **Required**: true

Usage statistics for different time periods.

#### [today](#response-usage-today)

- **Path**: `usage.today`
- **Type**: `object (2 properties)`
- **Required**: true

Usage stats for today.

##### [credits](#response-usage-today-credits)

- **Path**: `usage.today.credits`
- **Type**: `float`
- **Required**: true

Total credits consumed.

##### [requests](#response-usage-today-requests)

- **Path**: `usage.today.requests`
- **Type**: `integer`
- **Required**: true

Total API requests made.

#### [last7Days](#response-usage-last7days)

- **Path**: `usage.last7Days`
- **Type**: `object (2 properties)`
- **Required**: true

Usage stats for the last 7 days.

##### [credits](#response-usage-last7days-credits)

- **Path**: `usage.last7Days.credits`
- **Type**: `float`
- **Required**: true

Total credits consumed.

##### [requests](#response-usage-last7days-requests)

- **Path**: `usage.last7Days.requests`
- **Type**: `integer`
- **Required**: true

Total API requests made.

#### [last30Days](#response-usage-last30days)

- **Path**: `usage.last30Days`
- **Type**: `object (2 properties)`
- **Required**: true

Usage stats for the last 30 days.

##### [credits](#response-usage-last30days-credits)

- **Path**: `usage.last30Days.credits`
- **Type**: `float`
- **Required**: true

Total credits consumed.

##### [requests](#response-usage-last30days-requests)

- **Path**: `usage.last30Days.requests`
- **Type**: `integer`
- **Required**: true

Total API requests made.

#### [total](#response-usage-total)

- **Path**: `usage.total`
- **Type**: `object (2 properties)`
- **Required**: true

Total lifetime usage stats.

##### [credits](#response-usage-total-credits)

- **Path**: `usage.total.credits`
- **Type**: `float`
- **Required**: true

Total credits consumed.

##### [requests](#response-usage-total-requests)

- **Path**: `usage.total.requests`
- **Type**: `integer`
- **Required**: true

Total API requests made.