Credits
Manage group credits (stored-value codes) for the group that owns an event. Credits are group-scoped and usable across every event in the group; they are managed under the event so the event-bound integration can reach them. Returns 422 if the event is not part of a group.
Pass the access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
The unique handle (slug) of the event
nyc_marathon_2025OK
Unauthorized - invalid or missing token
Forbidden - user is not an admin of this event
Event not found
GET /api/v1/events/{handle}/credits HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Accept: */*
{
"credits": [
{
"id": 1,
"code": "text",
"amount_cents": 1,
"amount_dollars": 1,
"remaining_balance_cents": 1,
"remaining_balance_dollars": 1,
"currency": "text",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true
}
]
}Creates a credit on the event's group. amount_cents sets both the face value and the starting balance. Returns 422 if the event is not part of a group, if the code is missing or already used within the group, if amount_cents is missing or non-positive, or if the currency is unsupported. When email_credit_to_participant is not false and an email is present, the recipient is emailed.
Pass the access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
The unique handle (slug) of the event
nyc_marathon_2025Defaults to true; set false to suppress the recipient email on create.
Created
Unauthorized - invalid or missing token
Forbidden - user is not an admin of this event
Event not found
Validation error
POST /api/v1/events/{handle}/credits HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Content-Type: application/json
Accept: */*
Content-Length: 213
{
"code": "text",
"currency": "USD",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true,
"email_credit_to_participant": true,
"amount_cents": 1
}{
"credit": {
"id": 1,
"code": "text",
"amount_cents": 1,
"amount_dollars": 1,
"remaining_balance_cents": 1,
"remaining_balance_dollars": 1,
"currency": "text",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true
}
}Pass the access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
The unique handle (slug) of the event
nyc_marathon_2025The ID of the resource
1OK
Unauthorized - invalid or missing token
Forbidden - user is not an admin of this event
Event not found
GET /api/v1/events/{handle}/credits/{id} HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Accept: */*
{
"credit": {
"id": 1,
"code": "text",
"amount_cents": 1,
"amount_dollars": 1,
"remaining_balance_cents": 1,
"remaining_balance_dollars": 1,
"currency": "text",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true
}
}Deletes a credit. Returns 422 if the credit has already been used (it has usage records representing money applied to participants).
Pass the access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
The unique handle (slug) of the event
nyc_marathon_2025The ID of the resource
1OK
Unauthorized - invalid or missing token
Forbidden - user is not an admin of this event
Event not found
Validation error
DELETE /api/v1/events/{handle}/credits/{id} HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Accept: */*
{
"ok": true
}Updates credit metadata. amount_cents, when supplied, is treated as the new face value: the same delta is applied to the remaining balance so the ledger stays reconciled. A decrease below the amount already spent is rejected with 422.
Pass the access token in the Authorization header:
Authorization: Bearer YOUR_ACCESS_TOKEN
The unique handle (slug) of the event
nyc_marathon_2025The ID of the resource
1Defaults to true; set false to suppress the recipient email on create.
New face value; the same delta is applied to the remaining balance.
OK
Unauthorized - invalid or missing token
Forbidden - user is not an admin of this event
Event not found
Validation error
PATCH /api/v1/events/{handle}/credits/{id} HTTP/1.1
Host: www.movemint.cc
Authorization: Bearer Paste your OAuth access token here
Content-Type: application/json
Accept: */*
Content-Length: 213
{
"code": "text",
"currency": "USD",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true,
"email_credit_to_participant": true,
"amount_cents": 1
}{
"credit": {
"id": 1,
"code": "text",
"amount_cents": 1,
"amount_dollars": 1,
"remaining_balance_cents": 1,
"remaining_balance_dollars": 1,
"currency": "text",
"expiration_date": "2026-01-01T00:00:00.000Z",
"first_name": "text",
"last_name": "text",
"email": "text",
"applies_to_merchandise": true
}
}Last updated