# List accounts

URL: /en/docs/api/v1/accounts/get
Last Updated: 2026-07-30T21:15:44.917Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/accounts

**List accounts**

Retrieve all accounts that belong to the current tenant, with optional filtering and pagination.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Query parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | No | Search accounts by title or description |
| `status` | enum: to_review \| in_review \| approved \| cancelled | No | Filter by review status |

**Responses:**

- `200` - List of accounts for the current tenant
  - `accounts` (array of Account (object))
    - `id` (string (uuid)): Unique account identifier
    - `title` (string): Account/company name
    - `description` (string): Account description or notes
    - `review_status` (enum: to_review | in_review | approved | cancelled): Current review status for compliance
    - `sfdc_account_id` (string): Salesforce account ID for integration
    - `domain` (string): Primary domain for the account
    - `logo` (string): URL to account logo
    - `access_expiry_datetime` (string (date-time)): When account access expires
    - `nda` (boolean): Whether NDA is required for this account
    - `type` (enum: standard | enterprise): Account tier/type
    - `internal_notes` (string): Internal notes not visible to account users
    - `auto_approval` (boolean): Whether to automatically approve access requests from this account's domain
    - `date_created` (string (date-time)): Account creation timestamp
    - `contacts` (array of Contact (object)): Associated contact persons
      - `id` (string (uuid)): Contact identifier
      - `email` (string (email)): Contact email address
      - `first_name` (string): Contact first name
      - `last_name` (string): Contact last name
      - `title` (string): Contact job title

  Example (Successful response):
  
  ```json
  {
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Burger King",
      "description": "Fast-food chain EU division",
      "review_status": "completed",
      "type": "enterprise",
      "domain": "burgerking.com",
      "date_created": "2025-01-15T10:00:00Z"
    }
  ]
}
  ```
- `401` - Unauthorized - invalid or missing authentication token
- `403` - Forbidden - insufficient permissions for tenant access
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/accounts" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```