List Venue Types

GET /vendor//venue_types

GET /vendor/{org_token}/venue_types

Returns the full venue type taxonomy. This is a read-only endpoint — venue types are managed centrally and cannot be created or modified through the API.

Path parameters

Parameter	Type	Required	Description
org_token	string	Yes	Your organization token (find it here)

Example request

curl -X GET "https://api.framen.com/vendor/Org_9WeJxcVrRnM/venue_types"

The Venue Type object

Field	Type	Description
id	string	Unique venue type identifier
label	string	Human-readable name (e.g., “Airport”, “Shopping Mall”)
parent_id	string | null	ID of the parent venue type. null for level 1 entries.
level	int	Hierarchy level: 1, 2, or 3
selectable	boolean	Whether this type can be assigned to a location or screen
description	string | null	Explanation of what this venue type represents

Hierarchy levels

Level	Selectable	Assign to	Example
1	No	—	“Transit”, “Retail”, “Hospitality”
2	Yes	Locations	”Airport”, “Shopping Mall”, “Hotel”
3	Yes	Screens	”Arrival Hall (Airport)”, “Food Court (Mall)”

See Venue Type Hierarchy for details on the structure and assignment rules.

Example response

[
  {
    "label": "Transit",
    "id": "1",
    "parent_id": null,
    "level": 1,
    "selectable": false,
    "description": null
  },
  {
    "label": "Airport",
    "id": "101",
    "parent_id": "1",
    "level": 2,
    "selectable": true,
    "description": "Signage located throughout terminals in arrival and departure areas, ticketing areas, baggage claim, gate-hold rooms, concourses, retail shops, and VIP lounges."
  },
  {
    "label": "Arrival Hall (Airport)",
    "id": "10101",
    "parent_id": "101",
    "level": 3,
    "selectable": true,
    "description": "Signage is positioned at locations for meeting passengers arriving on flights."
  }
]

Response

Returns an array of all venue types in the taxonomy. There is no pagination or filtering — the full taxonomy is returned in a single response. Cache this response and refresh periodically (e.g., daily) rather than fetching it on every operation.