Skip to main content
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

ParameterTypeRequiredDescription
org_tokenstringYesYour organization token (find it here)

Example request

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

The Venue Type object

FieldTypeDescription
idstringUnique venue type identifier
labelstringHuman-readable name (e.g., “Airport”, “Shopping Mall”)
parent_idstring | nullID of the parent venue type. null for level 1 entries.
levelintHierarchy level: 1, 2, or 3
selectablebooleanWhether this type can be assigned to a location or screen
descriptionstring | nullExplanation of what this venue type represents

Hierarchy levels

LevelSelectableAssign toExample
1No“Transit”, “Retail”, “Hospitality”
2YesLocations”Airport”, “Shopping Mall”, “Hotel”
3YesScreens”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.