curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts"
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts")
.header("x-api-key", "<api-key>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"alertId": "alr_01kv60qge5eh59ap0gw0pqrrys",
"kind": "LESSON_MOVED",
"audience": "SUPPLIER",
"createdAt": "2026-09-26T14:05:00.000Z",
"occurredAt": "2026-09-26T14:04:58.000Z",
"target": {
"kind": "booking",
"bookingId": "bk_01kv60qge5eh59ap0gw0pqrrys"
},
"payload": {
"clientName": "Jordan Lee",
"supplierName": "Sam Rivera",
"serviceName": "Private swim lesson",
"startUtc": "2026-10-02T14:00:00.000Z",
"zone": "America/Toronto",
"count": 4,
"emailType": "BOOKING_CONFIRMATION",
"ratingStars": 5,
"inviteeName": "Sam Rivera",
"paymentReason": "DISPUTE_OPENED"
},
"readAt": "2026-09-26T15:00:00.000Z",
"resolvedAt": "2026-09-27T09:12:00.000Z"
}
],
"nextCursor": null
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}List the signed-in supplier’s alerts
The supplier’s alerts — new, moved and cancelled bookings — newest first, as the bell in the MarketBox dashboard lists them, read by the same code from the same inbox. Each row carries a target naming what it is about ({ kind: "booking", bookingId }); map it to your own page, since alerts hold no URL. readAt is absent while unread. Alerts are kept 90 days. Paginated with limit (1–100, default 20) and an opaque cursor; a cursor from another filter is 400 INVALID_CURSOR. Requires the API key and the supplier’s user token.
curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts"
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts")
.header("x-api-key", "<api-key>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/me/alerts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"alertId": "alr_01kv60qge5eh59ap0gw0pqrrys",
"kind": "LESSON_MOVED",
"audience": "SUPPLIER",
"createdAt": "2026-09-26T14:05:00.000Z",
"occurredAt": "2026-09-26T14:04:58.000Z",
"target": {
"kind": "booking",
"bookingId": "bk_01kv60qge5eh59ap0gw0pqrrys"
},
"payload": {
"clientName": "Jordan Lee",
"supplierName": "Sam Rivera",
"serviceName": "Private swim lesson",
"startUtc": "2026-10-02T14:00:00.000Z",
"zone": "America/Toronto",
"count": 4,
"emailType": "BOOKING_CONFIRMATION",
"ratingStars": 5,
"inviteeName": "Sam Rivera",
"paymentReason": "DISPUTE_OPENED"
},
"readAt": "2026-09-26T15:00:00.000Z",
"resolvedAt": "2026-09-27T09:12:00.000Z"
}
],
"nextCursor": null
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}Authorizations
API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.