---
title: "Account reference"
url: "https://lookvalid.com/docs/api/account.md"
canonical_url: "https://lookvalid.com/docs/api/account"
last_updated: "2026-10-22"
type: "reference"
summary: "Request and response reference for Account: parameters, response fields, credit cost and error codes."
related: ["https://lookvalid.com/docs/errors.md"]
---

# Account reference

Request and response reference for Account: parameters, response fields, credit cost and error codes.

Balance and API keys. Returns the credit balance and a summary of the account API keys. Never returns a full key.

```http
GET https://YOUR_API_HOST/v1/account
```

## Credits

Free. This endpoint never spends credits.

## Example request

**cURL**

```sh
curl https://YOUR_API_HOST/v1/account \
  -H "Authorization: Bearer $LOOKVALID_API_KEY"
```

**Node.js**

```js
const response = await fetch("https://YOUR_API_HOST/v1/account", {
  headers: { Authorization: `Bearer ${process.env.LOOKVALID_API_KEY}` },
});
console.log(await response.json());
```

**Python**

```python
import os
import requests

response = requests.get(
    "https://YOUR_API_HOST/v1/account",
    headers={"Authorization": f"Bearer {os.environ['LOOKVALID_API_KEY']}"},
    timeout=30,
)
print(response.json())
```

## Response

| Field | Type | Notes |
| --- | --- | --- |
| `account` | object | - |
| `account.id` | string | - |
| `account.name` | string | - |
| `account.created_at` | string | Format: date-time. |
| `balance` | object | - |
| `balance.granted` | integer | - |
| `balance.spent` | integer | - |
| `balance.reserved` | integer | Credits held by lookups still in flight. |
| `balance.available` | integer | Credits you can spend now. |
| `keys` | array of object | - |
| `keys[].id` | string | Public key id. The key itself is never returned. |
| `keys[].prefix` | string | - |
| `keys[].name` | string | - |
| `keys[].created_at` | string | Format: date-time. |
| `keys[].revoked` | boolean | - |
| `keys[].revoked_at` | string or null | Format: date-time. |

### Response shape

Each value is a stand-in that shows the field type.

```json
{
  "account": {
    "id": "string",
    "name": "string",
    "created_at": "string"
  },
  "balance": {
    "granted": 0,
    "spent": 0,
    "reserved": 0,
    "available": 0
  },
  "keys": [
    {
      "id": "string",
      "prefix": "string",
      "name": "string",
      "created_at": "string",
      "revoked": false,
      "revoked_at": "string"
    }
  ]
}
```

## Errors

- `401` [`unauthorized`](https://lookvalid.com/docs/errors.md#unauthorized): The API key is missing, malformed, revoked or unknown.
- `429` [`rate_limited`](https://lookvalid.com/docs/errors.md#rate_limited): Too many requests for this API key.

## Related

- [Errors](https://lookvalid.com/docs/errors.md)