# Account

The Account API exposes the metadata associated with the authenticated API key: the owning user, organization, the scopes granted, and the remaining lookup quota.

## Get account info (GET /api/v4/account/me)

Returns information about the authenticated account, including the owning user, organization, granted scopes, and the remaining lookup quota.

### Response

- `first_name` `string` — First name of the account owner.
- `last_name` `string` — Last name of the account owner.
- `email` `string` — Email address of the account owner.
- `organization` `object` — The organization the API key belongs to.
- `organization.id` `string` — Unique organization identifier.
- `organization.name` `string` — Display name of the organization.
- `organization.relation` `string` — Relationship of the user to the organization. One of `OWNER`, `ADMIN`, or `MEMBER`.
- `scopes` `array<string>` — Scopes granted to the API key, such as `BASIC`, `PROXY_FIREHOSE`, or `ANONYMIZERS_FEED`. See the table below for the full list.
- `lookup_quota` `object` — Remaining lookup quota for the current billing period.
- `lookup_quota.credits` `integer` — Lookup credits remaining.
- `lookup_quota.resets_in` `integer` — Seconds until the credit balance resets.

**Request** `GET /api/v4/account/me`

```bash title="cURL"
curl -G https://api.synthient.com/api/v4/account/me \
  -H "x-api-key: $SYNTHIENT_API_KEY"
```

```bash title="CLI"
synthient account
```

```python title="Python"
import os, requests

res = requests.get(
    'https://api.synthient.com/api/v4/account/me',
    headers={'x-api-key': os.environ['SYNTHIENT_API_KEY']},
)
data = res.json()
```

**Response**

```json title="200"
{
  "first_name": "Ada",
  "last_name": "Lovelace",
  "email": "ada@example.com",
  "organization": {
    "id": "org_01J5XK2ZQ8R6VBT3WE6E7C9D2H",
    "name": "Analytical Engine, Inc.",
    "relation": "OWNER"
  },
  "scopes": [
    "BASIC",
    "PROXY_FEEDS",
    "PROXY_FIREHOSE",
    "ANONYMIZERS_FEED"
  ],
  "lookup_quota": {
    "credits": 982341,
    "resets_in": 1893456
  }
}
```

```json title="401"
{ "detail": "Invalid API Key" }
```

```json title="500"
{ "detail": "Internal Server Error" }
```

## Scopes

The `scopes` array on the response lists which capabilities your API key has been granted. Each feed exposes two independent scopes: a `*_FEED` scope for the parquet-snapshot exports and a `*_STREAM` scope (or `PROXY_FIREHOSE` for proxies) for the real-time NDJSON stream.

| Scope                                           | Grants                                                                                                                                                     |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `BASIC`                                         | IP and domain lookups: `GET /api/v4/lookup/ip/{ip}`, `POST /api/v4/lookup/ips`, `GET /api/v4/lookup/domain/{domain}`. Also required for `GET /account/me`. |
| `PROXY_FEEDS`                                   | `proxies` parquet exports (`/api/v4/feeds/proxies/export*`).                                                                                               |
| `PROXY_FIREHOSE`                                | `proxies` real-time NDJSON stream.                                                                                                                         |
| `ANONYMIZERS_FEED`                              | `anonymizers` parquet exports.                                                                                                                             |
| `ANONYMIZERS_STREAM`                            | `anonymizers` real-time stream.                                                                                                                            |
| `TORRENTS_FEED` / `TORRENTS_STREAM`             | BitTorrent peer-observation exports / stream.                                                                                                              |
| `HONEYPOT_HTTP_FEED` / `HONEYPOT_HTTP_STREAM`   | HTTP honeypot exports / stream.                                                                                                                            |
| `HONEYPOT_HTTPS_FEED` / `HONEYPOT_HTTPS_STREAM` | TLS honeypot (ClientHello) exports / stream.                                                                                                               |
| `HONEYPOT_DNS_FEED` / `HONEYPOT_DNS_STREAM`     | DNS honeypot exports / stream.                                                                                                                             |
| `HONEYPOT_ADB_FEED` / `HONEYPOT_ADB_STREAM`     | Android Debug Bridge honeypot exports / stream.                                                                                                            |

A request to an endpoint your key isn't scoped for returns [`403 Forbidden`](https://docs.synthient.com/errors). See [Authentication](https://docs.synthient.com/authentication) for the full key-management model.