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

# List Venue Types

> Retrieve all available venue types.

## List Venue Types

Retrieve all available venue types. Venue types classify locations and screens into a **3-level hierarchy**:

* **Level 1** -- Category (not selectable, e.g., "Retail")
* **Level 2** -- Venue type (selectable, e.g., "Grocery")
* **Level 3** -- Sub-venue type (selectable, e.g., "Shop Entrance (Grocery)")

The `id` values returned here are used as `venue_type_id` in both the Screens and Locations endpoints.

**Constraint:** Locations must use a level 2 `venue_type_id`. Screens must use a `venue_type_id` that is either the same as their parent Location's (level 2) or one of its children (level 3).

<ParamField path="org_token" type="string" required>
  Your organization token (e.g., `Org_4KmTqZnWpLx`).
</ParamField>

### Response

Returns an array of venue type objects.

| Field         | Type           | Description                                                      |
| ------------- | -------------- | ---------------------------------------------------------------- |
| `label`       | string         | Display name (e.g., "Grocery")                                   |
| `id`          | string         | Venue type ID (used as `venue_type_id` in Screens and Locations) |
| `parent_id`   | string \| null | ID of the parent venue type. `null` for level 1                  |
| `level`       | integer        | `1` = category, `2` = venue type, `3` = sub-venue type           |
| `selectable`  | boolean        | Whether this type can be assigned to a Location or Screen        |
| `description` | string \| null | Human-readable description of the venue type                     |

### Example Request

```bash theme={null}
curl -X GET https://api.framen.com/vendor/Org_4KmTqZnWpLx/venue_types
```

### Example Response

```json theme={null}
[
  {
    "label": "Retail",
    "id": "2",
    "parent_id": null,
    "level": 1,
    "selectable": false,
    "description": "These dynamic screens are strategically placed in key locations throughout shopping centers, malls, and retail districts."
  },
  {
    "label": "Grocery",
    "id": "203",
    "parent_id": "2",
    "level": 2,
    "selectable": true,
    "description": "Digital signage is dispersed throughout supermarkets, you'll often find screens in direct view of shoppers, above cash points, at the entrance/exit, within the shelves, in the aisles and on the walls."
  },
  {
    "label": "Shop Entrance (Grocery)",
    "id": "20301",
    "parent_id": "203",
    "level": 3,
    "selectable": true,
    "description": "As shoppers enter the supermarket, there'll usually be medium to large sized screens close to the entrance, so consumers have a prominent view of ads."
  },
  {
    "label": "Check Out (Grocery)",
    "id": "20302",
    "parent_id": "203",
    "level": 3,
    "selectable": true,
    "description": "The till areas are where consumers pay for their purchases, and here you'll find display monitors close to the bagging area or above the self-service check out points."
  }
]
```