Enterprise Management

GET /api/v1/admin/enterprises

{
  "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": { ... }
}

POST /api/v1/admin/enterprises

{
  "name": "New Corporation",
  "country": "BR",
  "registration_number": "12.345.678/0001-90"
}

{
  "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"
}

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

{
  "status": "inactive",
  "subscription_tier": "professional"
}

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