List gig songs

​

A song on one gig, inside one of the gig’s products, on a named list: the couple’s request, the set list, a favorite, the playlist, or do not play. A request holds what the couple wrote until the band leader connects it to a song in the library.

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: title, artist, link, gig_product_id, list, song_id, gig_moment_id, performance, length, set, order, singer_id, second_vocalist, notes, internal_notes, library_decision, added_by, completed_at, set_aside_at, created_time, last_edited_time, id. Default: list,set,order,created_time.

  • fields
    Type: string

    Comma-separated subset of fields to return. id is always included.

  • filter[title]

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

  • filter[artist]

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

  • filter[link]

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

  • filter[gig_product_id]

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

  • filter[list]

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

  • filter[song_id]

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

  • filter[gig_moment_id]

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

  • filter[performance]

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

  • filter[length]

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

  • filter[set]

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

  • filter[order]

    Shorthand filter[order]=value means equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.

  • filter[singer_id]

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

  • filter[second_vocalist]

    Shorthand filter[second_vocalist]=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.

  • filter[internal_notes]

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

  • filter[library_decision]

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

  • filter[added_by]

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

  • filter[completed_at]

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

  • filter[set_aside_at]

    Shorthand filter[set_aside_at]=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.

  • 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.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/gig-songs
curl 'https://api.weddingoperatingsystems.com/api/v1/gig-songs?limit=50&offset=0&sort=list%2Cset%2Corder%2Ccreated_time' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": null,
      "artist": null,
      "link": null,
      "gig_product_id": null,
      "list": "request",
      "song_id": null,
      "gig_moment_id": null,
      "performance": "live",
      "length": "shortened",
      "set": null,
      "order": null,
      "singer_id": null,
      "second_vocalist": null,
      "notes": null,
      "internal_notes": null,
      "library_decision": "in_library",
      "added_by": "couple",
      "completed_at": null,
      "set_aside_at": null,
      "created_time": "2026-10-05T17:38:27.324Z",
      "last_edited_time": "2026-10-05T17:38:27.324Z",
      "stage": "needs_decision"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 1,
    "offset": 1
  }
}

A page of gig songs.

A Wedding Operating Systems, LLC product hireorpheus.com