List gig contacts

A contact’s connection to a gig, with the role(s) they play on it (Bride, Planner, Photographer, …). Unique per (gig, contact); both FKs required — a link cannot exist without both ends. Replaces the QB relationship grab-bag (contact↔venue links deliberately not modeled).

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: label, gig_id, contact_id, roles, created_time, last_edited_time, id. Default: created_time.
fields
Type: string

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

Shorthand filter[label]=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[label]=value means equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
filter[gig_id]

Shorthand filter[gig_id]=value means equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
Type: stringFormat: uuid

Shorthand filter[gig_id]=value means equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
filter[contact_id]

Shorthand filter[contact_id]=value means equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
Type: stringFormat: uuid

Shorthand filter[contact_id]=value means equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
filter[roles]

Shorthand filter[roles]=value means equals. Operators: contains, does_not_contain, is_empty, is_not_empty.
Type: stringenum

Shorthand filter[roles]=value means equals. Operators: contains, does_not_contain, is_empty, is_not_empty.

values
Bride
Groom
Planner
Assistant Planner
Functioning As Planner
Event Organizer
Client - Signatory
Primary Point of Contact
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/gig-contacts

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

Show Schema

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "label": null,
      "gig_id": null,
      "contact_id": null,
      "roles": [
        "Bride"
      ],
      "created_time": "2026-10-14T08:02:53.591Z",
      "last_edited_time": "2026-10-14T08:02:53.591Z"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 1,
    "offset": 1
  }
}

A page of gig contacts.

Set a song request aside

Create a gig contact