curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations', 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}/locations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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}/locations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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}/locations")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"locationId": "loc_01kv60qh7rf3d9mn2ptxwa5zbc",
"projectId": "prj_01kv60qgnef2kt3pvqgwmkbzfr",
"locationType": "PHYSICAL",
"name": "Bondi Pool",
"nameNormalized": "bondi pool",
"active": true,
"deleted": false,
"createdAt": "2026-10-01T14:00:00.000Z",
"updatedAt": "2026-10-01T14:00:00.000Z",
"defaultLanguage": "en",
"nameI18n": {
"en": "Bondi Pool",
"fr": "Piscine de Bondi"
},
"addressOneLine": "1 Beach Rd, Bondi NSW 2026, AU",
"street": "1 Beach Rd",
"city": "Bondi",
"state": "NSW",
"country": "AU",
"postalCode": "2026",
"longitude": 151.2743,
"latitude": -33.8915,
"timezone": "Australia/Sydney",
"travelZoneType": "CIRCULAR",
"travelDistance": 10,
"travelDistanceUnit": "KM",
"travelRegions": {
"type": "Polygon",
"coordinates": 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 locations for a project
The project’s locations: PHYSICAL venues where a service is delivered, VIRTUAL locations, and TRAVEL_ZONE areas a supplier travels within. Active locations only unless includeInactive=true; deleted locations are never returned. Filter by locationType, and within a type by namePrefix. Not paginated: a project holds tens of locations, read in one query and returned in one response. Display nameI18n in the reader’s language when present, falling back to name. Locations are created and edited in the MarketBox dashboard.
curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations', 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}/locations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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}/locations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
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}/locations")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/locations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"locationId": "loc_01kv60qh7rf3d9mn2ptxwa5zbc",
"projectId": "prj_01kv60qgnef2kt3pvqgwmkbzfr",
"locationType": "PHYSICAL",
"name": "Bondi Pool",
"nameNormalized": "bondi pool",
"active": true,
"deleted": false,
"createdAt": "2026-10-01T14:00:00.000Z",
"updatedAt": "2026-10-01T14:00:00.000Z",
"defaultLanguage": "en",
"nameI18n": {
"en": "Bondi Pool",
"fr": "Piscine de Bondi"
},
"addressOneLine": "1 Beach Rd, Bondi NSW 2026, AU",
"street": "1 Beach Rd",
"city": "Bondi",
"state": "NSW",
"country": "AU",
"postalCode": "2026",
"longitude": 151.2743,
"latitude": -33.8915,
"timezone": "Australia/Sydney",
"travelZoneType": "CIRCULAR",
"travelDistance": 10,
"travelDistanceUnit": "KM",
"travelRegions": {
"type": "Polygon",
"coordinates": 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.