# List sender accounts

`GET https://api.versionseven.ai/v1/accounts`

Every LinkedIn and email account connected to your organization for outreach, with its status. An account with `is_active: false` has been disconnected, usually by an authentication error, and needs to be reconnected: in the Victoria AI app, or with a [reconnect link](https://docs.versionseven.ai/api-reference/accounts/create-connect-link).

- Required scope: `accounts:read`

## Request

**cURL**

```bash
curl "https://api.versionseven.ai/v1/accounts" \
  -H "Authorization: Bearer $VICTORIA_API_KEY"
```

**Node.js**

```javascript
const response = await fetch("https://api.versionseven.ai/v1/accounts", {
  headers: {
    Authorization: `Bearer ${process.env.VICTORIA_API_KEY}`,
  },
});

const data = await response.json();
```

**Python**

```python
import os

import requests

response = requests.get(
    "https://api.versionseven.ai/v1/accounts",
    headers={
        "Authorization": f"Bearer {os.environ['VICTORIA_API_KEY']}",
    },
)
data = response.json()
```

## Headers

- `Authorization` (string, required): `Bearer` followed by a space and your API key, for example `Bearer vk_…`.

## Query parameters

- `limit` (integer, optional, ≥ 1, ≤ 500, default `500`): Maximum rows to return
- `offset` (integer, optional, ≥ 0, default `0`): Rows to skip before returning results

## Response

### `200`

```json
{
  "total": 1,
  "limit": 1,
  "offset": 1,
  "has_more": true,
  "accounts": [
    {
      "account_id": "739b093a-e9fb-4013-a24b-a87a4069d38a",
      "created_at": "2026-01-14T19:30:00+00:00",
      "email": "jane@example.com",
      "id": "a5614527-0ce6-43be-bd1d-d012b7394867",
      "is_active": true,
      "organization_id": "073d93c2-6786-4467-a327-7342ce462caf",
      "platform": "string",
      "platform_username": "string",
      "system_id": "e73f154e-2c31-4392-90a5-2367f25559ec",
      "user_id": "f89d6b69-6045-4241-bc5b-09b4d0d8ad86"
    }
  ],
  "count": 0,
  "success": true
}
```

- `total` (integer, required): Total rows matching the query, across all pages
- `limit` (integer, required): Page size that was applied
- `offset` (integer, required): Rows skipped before this page
- `has_more` (boolean, required): Whether a further page exists
- `accounts` (array of objects, optional)
  - `account_id` (string or null, optional): The account's ID at the messaging provider that sends on its behalf.
  - `created_at` (string · date-time or null, optional)
  - `email` (string or null, optional)
  - `id` (string or null, optional)
  - `is_active` (boolean or null, optional): false = disconnected, needs reconnect
  - `organization_id` (string or null, optional)
  - `platform` (string or null, optional): linkedin | email
  - `platform_username` (string or null, optional)
  - `system_id` (string or null, optional)
  - `user_id` (string or null, optional)
- `count` (integer, optional, default `0`): Accounts in this page. Deprecated: use `total`
- `success` (boolean, optional, default `true`)

## Errors

Errors share one JSON body: `success`, `error`, `message`, optional `details`, and `request_id`. For example:

```json
{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Invalid or inactive API key",
  "request_id": "734d11a1-54d4-414c-9e8d-4e1ada977db4"
}
```

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `VALIDATION_ERROR` | The request didn't match the endpoint's schema: a missing or malformed field, a bad query parameter, or a value out of range. `details.errors` lists each failing field with its `field`, `message` and `type`. |
| 401 | `UNAUTHORIZED` | The `Authorization` header is missing or malformed, or the API key is unknown or has been deactivated. |
| 401 | `API_KEY_EXPIRED` | The API key is past its expiry date. Create a new key in the Victoria AI app. |
| 403 | `INSUFFICIENT_SCOPE` | The API key doesn't have the scope this endpoint requires, such as `leads:write`. |
| 403 | `ORGANIZATION_DEACTIVATED` | The organization that owns this API key has been deactivated. |
| 429 | `RATE_LIMITED` | Too many requests for this API key: more than 100 a minute to one endpoint, or 600 a minute in total. Retry after the number of seconds in the `Retry-After` header. See [Rate limits](https://docs.versionseven.ai/guides/rate-limits). |
| 500 | `INTERNAL_ERROR` | Something failed on our side. The response never includes internal details; quote its `request_id` when you contact support. |
| 503 | `UPSTREAM_TIMEOUT` | A service the API depends on timed out. The request is safe to retry. |
| 503 | `AUTH_UNAVAILABLE` | The API key couldn't be checked because the authentication service was unavailable. The request is safe to retry. |

## Response headers

| Header | Description |
| --- | --- |
| `X-Request-ID` | Correlation ID for the request, also returned as `request_id` in error bodies. Send your own `X-Request-ID`, up to 128 letters, digits, `.`, `_`, `:` or `-`, and it's used instead. |
| `RateLimit-Limit` | Requests allowed to this endpoint per minute. |
| `RateLimit-Remaining` | Requests you can still send to this endpoint right now. |
| `RateLimit-Reset` | Seconds until the endpoint's full limit is available again. |
| `Retry-After` | On a `429`: seconds to wait before retrying. |