# Get guest group list by tenant id.

`GET /public/api/v1/Tenants/{tenantId}/GuestGroups`

User API · GuestGroups · base URL `https://user-api.ancon.io` · auth: `Access-Token` header · docs: https://ancon.dev/api/user/guest-groups/get-guest-group-list-by-tenant-id

### Available filter properties
- name (string)
- signindiscountid (nullable guid)
- walletdiscountid (nullable guid)

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `tenantId` | string (uuid) | yes |  |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Extent.Discounts` | boolean | no |  |
| `Offset` | integer (int32) | no |  |
| `Limit` | integer (int32) | no | min 0, max 1000. |
| `Order` | string | no |  |
| `Search` | string | no |  |
| `Filter` | map<string, array<string>> | no |  |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `correlationId` | string | no | Correlation Id for the request |

## Responses

| Status | Description |
| --- | --- |
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |

### 200 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array<object> or null | no |  |
| `items[].id` | string (uuid) | no |  |
| `items[].name` | string or null | no |  |
| `items[].created` | string (date-time) | no |  |
| `items[].modified` | string (date-time) | no |  |
| `items[].hasAssignedGuests` | boolean | no |  |
| `items[].signInDiscountId` | string (uuid) or null | no |  |
| `items[].walletDiscountId` | string (uuid) or null | no |  |
| `items[].isDefault` | boolean | no |  |
| `meta` | object or null | no |  |
| `meta.count` | integer (int32) | no |  |
| `meta.offset` | integer (int32) | no |  |
| `discounts` | array<object> or null | no |  |
| `discounts[].id` | string (uuid) | no |  |
| `discounts[].name` | string or null | no |  |

#### Example (from schema)

```json
{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "created": "2026-01-15T12:00:00Z",
      "modified": "2026-01-15T12:00:00Z",
      "hasAssignedGuests": true,
      "signInDiscountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "walletDiscountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "isDefault": true
    }
  ],
  "meta": {
    "count": 0,
    "offset": 0
  },
  "discounts": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string"
    }
  ]
}
```

### 400 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |
| `errorCode` | string (uuid) | no |  |
| `additionalData` | any or null | no |  |

#### Example (from schema)

```json
{
  "message": "string",
  "errorCode": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "additionalData": null
}
```

### 404 response (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string or null | no |  |
| `errorCode` | string (uuid) | no |  |

#### Example (from schema)

```json
{
  "message": "string",
  "errorCode": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

## Example request

```bash
curl -X GET "https://user-api.ancon.io/public/api/v1/Tenants/{tenantId}/GuestGroups" \
  -H "Access-Token: $ANCON_TOKEN"
```