A venue is the physical location where events take place. Every event references a venue via venue_id — you must create venues (or look up their IDs) before creating events.

Default response fields

id, name, description, slug, created_at, updated_at, time_zone, tzinfo.

tzinfo is a convenience object with the venue’s timezone in multiple representations:

{
  "name": "Central Time (US & Canada)",
  "identifier": "America/Chicago",
  "offset": -21600,
  "formatted_offset": "-06:00"
}

The address relationship is returned only when listed in ?include=.

List venues

GET /venues

List venues

curl -X GET \
  'https://app.guestmanager.com/api/public/v2/venues?page[cursor]=&include=address' \
  -H 'Authorization: Token abcdefg' \
  -H 'Content-Type: application/json'

Request parameters

Parameter	Type	Description
page[cursor]	string	Opaque cursor token. Send empty for first page. See Pagination.
page[size]	integer	Records per page. Default 10, maximum 1000 for venues.
sort[{field}]	string	Sort by id, created_at, updated_at, name. Value is asc or desc.
include	string	address (with country and state).
filter[ids]	string	Comma separated venue IDs.
filter[archived]	boolean	true includes archived venues; false excludes them.

Get venue

GET /venues/{id}

curl -X GET \
  'https://app.guestmanager.com/api/public/v2/venues/2847?include=address' \
  -H 'Authorization: Token abcdefg' \
  -H 'Content-Type: application/json'

Create venue

POST /venues

curl -X POST \
  https://app.guestmanager.com/api/public/v2/venues \
  -H 'Authorization: Token abcdefg' \
  -H 'Content-Type: application/json' \
  -d '{
    "venue": {
      "name": "Texas Motor Speedway",
      "description": "Outdoor stadium",
      "time_zone": "Central Time (US & Canada)",
      "address": {
        "address1": "3545 Lone Star Cir",
        "city": "Fort Worth",
        "zipcode": "76177",
        "country_code": "US",
        "state_code": "TX"
      }
    }
  }'

Request parameters

Parameter	Type	Required	Description
venue[name]	string	yes	Venue name.
venue[time_zone]	string	yes	IANA identifier (e.g., America/Chicago) or Rails friendly name (e.g., Central Time (US & Canada)). When the IANA identifier has a Rails alias, the friendly form is what’s persisted and returned on read.
venue[description]	string	no	Description.
venue[address]	object	no	Address fields (see below).

Address fields

Pass nested under venue[address]. Either send country_code + state_code (ISO codes) or country_id + state_id.

Field	Type	Description
address1	string	Street address.
city	string	City.
zipcode	string	Postal/ZIP code.
country_code	string	ISO 3166-1 alpha-2 country code (e.g., US).
state_code	string	State/province code (e.g., TX).
country_id	integer	Country ID. Alternative to country_code.
state_id	integer	State ID. Alternative to state_code.
state	string	Free-text state name when no code applies.

Update venue

PATCH /venues/{id}

Same parameter shape as create. Pass only the fields you want to change.