> ## Documentation Index
> Fetch the complete documentation index at: https://openrush.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Account

> Manage credits, API keys, and usage activity.

The easiest way to manage account actions is [openrush.io](https://openrush.io). Most users should use the Dashboard instead of calling these endpoints directly.

Use:

* [API access](https://openrush.io/dashboard/api) to create, copy, and revoke API keys.
* [Activity](https://openrush.io/dashboard/usage) to review recent API and MCP requests.
* [Billing](https://openrush.io/dashboard/billing) to check your credit balance and buy credits.

The endpoints below are for developers who want to automate the same account actions.

## Credits

`GET /v1/me/credits`

Returns your current credit balance.

```bash theme={null}
curl "https://api.openrush.io/v1/me/credits" \
  -H "Authorization: Bearer $OPENRUSH_KEY"
```

Response:

```json theme={null}
{
  "balance": 500
}
```

## List API credentials

`GET /v1/me/api-credentials`

Lists API credentials for the current account. The raw key is not returned.

```bash theme={null}
curl "https://api.openrush.io/v1/me/api-credentials" \
  -H "Authorization: Bearer $OPENRUSH_KEY"
```

Response item:

```json theme={null}
{
  "id": "cred_...",
  "account_id": "acct_...",
  "name": "Production server",
  "prefix": "or_abc123...",
  "is_active": true,
  "created_at": "2026-06-26T12:00:00Z",
  "last_used_at": null,
  "expires_at": null
}
```

## Create API credential

`POST /v1/me/api-credentials`

Creates a new API key for the current account.

Request body:

| Field        | Type     | Required | Notes                         |
| ------------ | -------- | -------- | ----------------------------- |
| `name`       | string   | Yes      | 1-120 characters              |
| `expires_at` | datetime | No       | Optional expiration timestamp |

```bash theme={null}
curl -X POST "https://api.openrush.io/v1/me/api-credentials" \
  -H "Authorization: Bearer $OPENRUSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production server"}'
```

Response:

```json theme={null}
{
  "key": "or_...",
  "api_credential": {
    "id": "cred_...",
    "account_id": "acct_...",
    "name": "Production server",
    "prefix": "or_abc123...",
    "is_active": true,
    "created_at": "2026-06-26T12:00:00Z",
    "last_used_at": null,
    "expires_at": null
  }
}
```

<Warning>
  Copy the `key` immediately. OpenRush only shows the raw key once.
</Warning>

## Revoke API credential

`POST /v1/me/api-credentials/{credential_id}/revoke`

Revokes an API key owned by the current account. Any app or agent using that key stops working.

```bash theme={null}
curl -X POST "https://api.openrush.io/v1/me/api-credentials/$CREDENTIAL_ID/revoke" \
  -H "Authorization: Bearer $OPENRUSH_KEY"
```

## Usage

`GET /v1/me/usage`

Returns recent account activity. The app shows API and MCP requests in [Activity](https://openrush.io/dashboard/usage).

Query parameters:

| Field   | Type    | Default | Notes                     |
| ------- | ------- | ------- | ------------------------- |
| `limit` | integer | `50`    | Clamped between 1 and 500 |

```bash theme={null}
curl "https://api.openrush.io/v1/me/usage?limit=50" \
  -H "Authorization: Bearer $OPENRUSH_KEY"
```

Response item:

```json theme={null}
{
  "id": "log_...",
  "account_id": "acct_...",
  "credential_id": "cred_...",
  "auth_source": "api_key",
  "endpoint": "/v1/tools/inspect_domain",
  "method": "POST",
  "status_code": 200,
  "response_time_ms": 842,
  "request_bytes": 52,
  "response_bytes": 4096,
  "dataforseo_cost_usd": 0.0,
  "credits_charged": 3,
  "error_type": null,
  "error_message": null,
  "created_at": "2026-06-26T12:00:00Z"
}
```

## Billing in the app

Buy credits in [Billing](https://openrush.io/dashboard/billing). The current app shows your balance, supports purchases in \$10 increments, and sends you through secure checkout.

Use the app for purchases instead of building a separate payment flow.
