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

# Enterprise Management

> Manage enterprises (Super Admin only)

## List Enterprises

### Endpoint

```
GET /api/v1/admin/enterprises
```

### Required Role

* Super Admin

### Query Parameters

| Parameter   | Type    | Description                            |
| ----------- | ------- | -------------------------------------- |
| `status`    | string  | Filter by status: `active`, `inactive` |
| `page`      | integer | Page number                            |
| `page_size` | integer | Items per page                         |

### Response

```json theme={null}
{
  "data": [
    {
      "id": "ent-uuid-001",
      "name": "ACME Corporation",
      "country": "US",
      "registration_number": "REG-12345",
      "status": "active",
      "subscription_tier": "enterprise",
      "mrr_cents": 199900,
      "created_at": "2025-06-01T00:00:00Z",
      "user_count": 25,
      "bra_count": 15
    }
  ],
  "pagination": { ... }
}
```

***

## Create Enterprise

### Endpoint

```
POST /api/v1/admin/enterprises
```

### Required Role

* Super Admin

### Request Body

```json theme={null}
{
  "name": "New Corporation",
  "country": "BR",
  "registration_number": "12.345.678/0001-90"
}
```

### Response

```json theme={null}
{
  "data": {
    "id": "ent-uuid-new",
    "name": "New Corporation",
    "country": "BR",
    "registration_number": "12.345.678/0001-90",
    "status": "active",
    "subscription_tier": "starter",
    "created_at": "2026-01-16T10:00:00Z"
  },
  "message": "Enterprise created successfully"
}
```

***

## Update Enterprise

### Endpoint

```
PATCH /api/v1/admin/enterprises/{enterprise_id}
```

### Required Role

* Super Admin

### Request Body

```json theme={null}
{
  "status": "inactive",
  "subscription_tier": "professional"
}
```

### Response

```json theme={null}
{
  "data": {
    "id": "ent-uuid-001",
    "status": "inactive",
    "subscription_tier": "professional",
    "updated_at": "2026-01-16T10:00:00Z"
  },
  "message": "Enterprise updated successfully"
}
```