API reference — gigmoa

Authentication

Send your API key on every request — either as a header X-API-Key or as Authorization: Bearer <key>. Secret keys (gm_sk_…) are for server-side use; publishable keys (gm_pk_…) are for the browser widget and bound to your allowed domains.

Rate limits & errors

Responses use the envelope { success, data, meta }. Errors: 401 (missing/invalid key), 403 (scope or origin not allowed), 404 (not found), 429 (rate limit — back off and retry).

GET /events

List published events.

Parameters

Name	In	Description
market	query	Market code (e.g. JP). Within your allowed markets.
artist	query	Filter by artist slug.
category	query	Filter by artist category.
venue	query	Filter by venue id.
city	query	Filter by venue city.
q	query	Free-text search in title/description.
date_from	query	Only events on/after this date (ISO 8601).
date_to	query	Only events on/before this date (ISO 8601).
sort	query	date (upcoming first) or -date.
limit	query	Items per page (max 100, default 20).
cursor	query	Opaque cursor for the next page (from meta.next_cursor).
locale	query	Response language: en or ja (overrides Accept-Language).
include	query	Embed relations, e.g. tiers.

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/events?market=JP&limit=10"

Returns the standard envelope { success, data, meta }.

GET /events/{slug}

A single event including ticket tiers.

Parameters

Name	In	Description
slug	path	The resource slug.
locale	query	Response language: en or ja (overrides Accept-Language).
include_translations	query	Return both en and ja for text fields (1).

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/events/blue-note-live-2026"

Returns the standard envelope { success, data, meta }.

GET /artists

List approved artists.

Parameters

Name	In	Description
market	query	Market code (e.g. JP). Within your allowed markets.
category	query	Filter by artist category.
type	query	Artist type: solo or band.
limit	query	Items per page (max 100, default 20).
cursor	query	Opaque cursor for the next page (from meta.next_cursor).
locale	query	Response language: en or ja (overrides Accept-Language).

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/artists?type=band"

Returns the standard envelope { success, data, meta }.

GET /artists/{slug}/events

Events of one artist.

Parameters

Name	In	Description
slug	path	The resource slug.
market	query	Market code (e.g. JP). Within your allowed markets.
locale	query	Response language: en or ja (overrides Accept-Language).
limit	query	Items per page (max 100, default 20).
cursor	query	Opaque cursor for the next page (from meta.next_cursor).
sort	query	date (upcoming first) or -date.
date_from	query	Only events on/after this date (ISO 8601).
date_to	query	Only events on/before this date (ISO 8601).
q	query	Free-text search in title/description.

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/artists/the-midnight-echoes/events"

Returns the standard envelope { success, data, meta }.

GET /venues/{id}/events

Events of one venue.

Parameters

Name	In	Description
venue_id	path	The venue id.
market	query	Market code (e.g. JP). Within your allowed markets.
locale	query	Response language: en or ja (overrides Accept-Language).
limit	query	Items per page (max 100, default 20).
cursor	query	Opaque cursor for the next page (from meta.next_cursor).
sort	query	date (upcoming first) or -date.
date_from	query	Only events on/after this date (ISO 8601).
date_to	query	Only events on/before this date (ISO 8601).
q	query	Free-text search in title/description.

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/venues/42/events"

Returns the standard envelope { success, data, meta }.

GET /markets

Available markets.

Parameters

Name	In	Description
locale	query	Response language: en or ja (overrides Accept-Language).

Example

curl -H "X-API-Key: gm_sk_live_xxx" \
     "https://vps.gigmoa.com/api/partner/v1/markets"

Returns the standard envelope { success, data, meta }.