API reference

Organisers

16 methods. Request fields, an example response, and notes on what comes back in data.

Base https://api.groove.com.na Updated October 2026

GET /api/organiser-activation/:token

Fetch one resource by id or token.

Public

Request

Parameter	In	Req.	Description
`token`	path	Y	Opaque session or activation token.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organiser-activation/:token

Create a resource or run this action.

Public

Request

Parameter	In	Req.	Description
`token`	path	Y	Opaque session or activation token.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

GET /api/organiser-applications

List or read resources for this path.

Bearer token

Request

Parameter	In	Req.	Description
`decision`	body	Y	One of: "approved", "declined".
`declineReason`	body	N	Text field (max 1000).
`reviewerNotes`	body	N	Text field (max 2000).
`riskLevel`	body	N	One of: "low", "medium", "high".

Example body

{
  "decision": "\u2026",
  "declineReason": "\u2026",
  "reviewerNotes": "\u2026",
  "riskLevel": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organiser-applications

Create a resource or run this action.

Public

Request

Parameter	In	Req.	Description
`contactName`	body	Y	Text field (min 2, max 80).
`organisationName`	body	Y	Text field (min 2, max 120).
`legalName`	body	N	Text field (max 160).
`email`	body	Y	Account email address (stored lowercase) (max 160).
`phone`	body	N	Contact mobile number in international or local form (max 40).
`city`	body	N	City name (max 80).
`country`	body	N	Text field (max 80).
`website`	body	N	Text field (max 200).
`pitch`	body	Y	Text field (min 20, max 2000).
`eventFocus`	body	N	Text field (max 400).
`capacityBand`	body	N	Enumerated string.
`socialHandle`	body	N	Text field (max 120).
`heardAbout`	body	N	Text field (max 120).
`termsAccepted`	body	Y	Request field. See Zod schema in the route module for constraints.

Example body

{
  "contactName": "Alex Organiser",
  "organisationName": "Sunset Events NA",
  "legalName": "Sunset Events (Pty) Ltd",
  "email": "organiser.apply@example.com",
  "phone": "+264811111111",
  "city": "Windhoek",
  "country": "Namibia",
  "website": "https://example.com",
  "pitch": "We produce mid-size music and lifestyle events across Namibia with a focus on cashless experiences.",
  "eventFocus": "Music festivals, nightlife",
  "capacityBand": "500_2000",
  "socialHandle": "@sunsetevents",
  "heardAbout": "Website",
  "termsAccepted": true
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

GET /api/organiser-applications/:applicationId

Fetch one resource by id or token.

Bearer token

Request

Parameter	In	Req.	Description
`applicationId`	path	Y	Path parameter identifying the resource.
`decision`	body	Y	One of: "approved", "declined".
`declineReason`	body	N	Text field (max 1000).
`reviewerNotes`	body	N	Text field (max 2000).
`riskLevel`	body	N	One of: "low", "medium", "high".

Example body

{
  "decision": "\u2026",
  "declineReason": "\u2026",
  "reviewerNotes": "\u2026",
  "riskLevel": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

PATCH /api/organiser-applications/:applicationId

Update selected fields on this resource.

Bearer token

Request

Parameter	In	Req.	Description
`applicationId`	path	Y	Path parameter identifying the resource.
`decision`	body	Y	One of: "approved", "declined".
`declineReason`	body	N	Text field (max 1000).
`reviewerNotes`	body	N	Text field (max 2000).
`riskLevel`	body	N	One of: "low", "medium", "high".

Example body

{
  "decision": "\u2026",
  "declineReason": "\u2026",
  "reviewerNotes": "\u2026",
  "riskLevel": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organiser-applications/:applicationId/resend-activation

Create a resource or run this action.

Bearer token

Request

Parameter	In	Req.	Description
`applicationId`	path	Y	Path parameter identifying the resource.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organisers

Create a resource or run this action.

Bearer token

Request

Parameter	In	Req.	Description
`name`	body	Y	Display name (min 2, max 200).
`email`	body	Y	Account email address (stored lowercase).
`legalName`	body	N	Text field (min 2, max 200).
`phone`	body	N	Contact mobile number in international or local form (min 4, max 32).
`website`	body	N	Text field (max 500).
`city`	body	N	City name (max 120).
`country`	body	N	Text field (max 120).

Example body

{
  "name": "\u2026",
  "email": "user@example.com",
  "legalName": "\u2026",
  "phone": "\u2026",
  "website": "\u2026",
  "city": "\u2026",
  "country": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

GET /api/organisers/me

List or read resources for this path.

Bearer token

Request

Parameter	In	Req.	Description
`name`	body	N	Display name (min 2, max 120).
`phone`	body	N	Contact mobile number in international or local form (min 4, max 32).
`preferences`	body	N	Boolean flag.

Example body

{
  "name": "\u2026",
  "phone": "\u2026",
  "preferences": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {
    "id": "66f0a1b2c3d4e5f678901234",
    "name": "Pat Fan",
    "email": "pat@example.com",
    "roles": [
      "customer"
    ],
    "phone": "+264811234567"
  }
}

Response data

Wrapped in the standard envelope (status, success, data, …). See the introduction for envelope fields.

Field	Description
`data.id`	Resource identifier (Mongo ObjectId string).
`data.name`	Human-readable name.
`data.email`	Email address.
`data.roles`	Array. Element shape shown when sample includes objects.
`data.phone`	Phone number when present on the profile.

PATCH /api/organisers/me

Update selected fields on this resource.

Bearer token

Request

Parameter	In	Req.	Description
`name`	body	N	Display name (min 2, max 120).
`phone`	body	N	Contact mobile number in international or local form (min 4, max 32).
`preferences`	body	N	Boolean flag.

Example body

{
  "name": "My Organiser Name"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

GET /api/organisers/team-invites

List or read resources for this path.

Bearer token

Request

No body or query parameters. Path values above, if any, are enough.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organisers/team-invites

Create a resource or run this action.

Bearer token

Request

Parameter	In	Req.	Description
`email`	body	Y	Account email address (stored lowercase).
`name`	body	N	Display name (min 1, max 120).
`role`	body	Y	Team or crew role label.

Example body

{
  "email": "teammate@example.com",
  "name": "Teammate",
  "role": "operations"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

GET /api/organisers/team-invites/:token

Fetch one resource by id or token.

Public

Request

Parameter	In	Req.	Description
`token`	path	Y	Opaque session or activation token.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organisers/team-invites/:token/accept

Create a resource or run this action.

Bearer token

Request

Parameter	In	Req.	Description
`token`	path	Y	Opaque session or activation token.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organisers/team-invites/:token/complete

Create a resource or run this action.

Public

Request

Parameter	In	Req.	Description
`token`	path	Y	Opaque session or activation token.

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

POST /api/organisers/upload-brand-logo

Create a resource or run this action.

Bearer token

Request

Parameter	In	Req.	Description
`email`	body	Y	Account email address (stored lowercase).
`name`	body	N	Display name (min 1, max 120).
`role`	body	Y	Team or crew role label.

Example body

{
  "email": "user@example.com",
  "name": "\u2026",
  "role": "\u2026"
}

Example response

{
  "status": "success",
  "success": true,
  "statusCode": "00000",
  "message": "OK",
  "shortMessage": "SUCCESS",
  "timestamp": "2026-10-10T21:00:00.000Z",
  "requestId": "a1b2c3d4e5f6g7h8",
  "data": {}
}

Response data

Success returns the standard envelope. data holds the payload for this method — confirm the shape in your client when integrating.

Lock this page again

Organisers · 16 methods · October 2026

Resolve this before you come in.

Request

Example response

Response data

Request

Example response

Response data

Request

Example body

Example response

Response data

Request

Example body

Example response

Response data

Request

Example body

Example response

Response data

Request

Example body

Example response

Response data

Request

Example response

Response data

Request

Example body

Example response

Response data

Request

Example body

Example response

Response data

Request

Example body

Example response

Response data

Request

Example response

Response data

Request

Example body

Example response

Response data

Request

Example response

Response data

Request

Example response

Response data

Request

Example response

Response data

Request

Example body

Example response

Response data