List venues

A place gigs happen, with the logistics every crew needs on arrival.

Query Parameters

limit
Type: integer
min:
0
max:
200

Page size, 50 by default, 200 at most.
offset
Type: integer
min:
0

Records to skip.
sort
Type: string

Comma-separated fields; prefix with - for descending. Sortable: name, street_1, street_2, city, state_region, postal_code, country, website, phone, load_in_notes, parking_notes, electrical_notes, elevator_notes, notes, created_time, last_edited_time, id. Default: name.
fields
Type: string

Comma-separated subset of fields to return. id is always included.
filter[name]

Shorthand filter[name]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[name]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[street_1]

Shorthand filter[street_1]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[street_1]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[street_2]

Shorthand filter[street_2]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[street_2]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[city]

Shorthand filter[city]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[city]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[state_region]

Shorthand filter[state_region]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[state_region]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[postal_code]

Shorthand filter[postal_code]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[postal_code]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[country]

Shorthand filter[country]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[country]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[website]

Shorthand filter[website]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: stringFormat: uri

Shorthand filter[website]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[phone]

Shorthand filter[phone]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[phone]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[load_in_notes]

Shorthand filter[load_in_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[load_in_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[parking_notes]

Shorthand filter[parking_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[parking_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[electrical_notes]

Shorthand filter[electrical_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[electrical_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[elevator_notes]

Shorthand filter[elevator_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[elevator_notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[notes]

Shorthand filter[notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
Type: string

Shorthand filter[notes]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[created_time]

Shorthand filter[created_time]=value means equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
Type: stringFormat: date-time

Shorthand filter[created_time]=value means equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
filter[last_edited_time]

Shorthand filter[last_edited_time]=value means equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
Type: stringFormat: date-time

Shorthand filter[last_edited_time]=value means equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.

Responses

application/json
application/json
application/json
application/json

get/venues

curl 'https://api.hireorpheus.com/api/v1/venues?limit=50&offset=0&sort=name' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": null,
      "street_1": null,
      "street_2": null,
      "city": null,
      "state_region": null,
      "postal_code": null,
      "country": null,
      "website": null,
      "phone": null,
      "load_in_notes": null,
      "parking_notes": null,
      "electrical_notes": null,
      "elevator_notes": null,
      "notes": null,
      "created_time": "2026-10-14T08:02:53.595Z",
      "last_edited_time": "2026-10-14T08:02:53.595Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 1,
    "offset": 1
  }
}

A page of venues.

Add a attachment to a gig

Create a venue