curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions"
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}/transactions', 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}/transactions",
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}/transactions"
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}/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions")
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": [
{
"projectId": "<string>",
"tenantId": "<string>",
"transactionId": "<string>",
"kind": "PAYMENT",
"source": "STRIPE",
"status": "PENDING",
"amount": {
"amount": 1,
"currency": "<string>"
},
"orderId": "<string>",
"deleted": true,
"version": 1,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"updatedBy": "<string>",
"platformFee": {
"amount": 1,
"currency": "<string>"
},
"relatedTransactionId": "<string>",
"orderItemId": "<string>",
"allocationId": "<string>",
"bookingId": "<string>",
"clientId": "<string>",
"stripePaymentIntentId": "<string>",
"stripeChargeId": "<string>",
"stripeRefundId": "<string>",
"stripeAccountId": "<string>",
"connectChargeType": "DIRECT",
"failureCode": "<string>",
"failureMessage": "<string>",
"note": "<string>",
"disputeId": "<string>",
"disputeStatus": "needs_response",
"channel": "BACKOFFICE",
"reason": "<string>"
}
],
"nextCursor": "<string>"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}List transactions (filter by order, client, or status)
The money ledger for the project, newest first, for reconciliation and payment history.
The filters are not combinable, and this is the mistake to avoid: exactly one of orderId, clientId and status takes effect, in that order of precedence, and the others are ignored without an error. Sending orderId with status=FAILED returns EVERY transaction on that order, failed or not — so filter by status client-side when you also need one of the others. With none of the three set, the whole project is listed. startDate and endDate are the exception: they narrow whichever of the four queries runs.
Results are paginated with an opaque cursor that is only valid for the same filters that produced it. Both settled and unsettled rows come back, so sum only status: "SUCCEEDED" when computing what was actually collected — a PENDING Stripe row is an intent, not money.
The ledger is append-only, so a correction is always a NEW row pointing at the one it corrects through relatedTransactionId, never an edit. Amounts are always positive; the kind carries the direction. A REFUND offsets a PAYMENT, and a CREDIT_REVERSAL offsets the CREDIT_REDEMPTION of a package session that was cancelled and returned to its package — so package credit actually used is redemptions minus reversals. Neither credit kind is money: both have source: "PACKAGE_CREDIT". A consumer switching exhaustively on kind should tolerate values it does not know.
curl --request GET \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions \
--header 'x-api-key: <api-key>'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions"
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}/transactions', 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}/transactions",
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}/transactions"
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}/transactions")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/transactions")
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": [
{
"projectId": "<string>",
"tenantId": "<string>",
"transactionId": "<string>",
"kind": "PAYMENT",
"source": "STRIPE",
"status": "PENDING",
"amount": {
"amount": 1,
"currency": "<string>"
},
"orderId": "<string>",
"deleted": true,
"version": 1,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>",
"updatedBy": "<string>",
"platformFee": {
"amount": 1,
"currency": "<string>"
},
"relatedTransactionId": "<string>",
"orderItemId": "<string>",
"allocationId": "<string>",
"bookingId": "<string>",
"clientId": "<string>",
"stripePaymentIntentId": "<string>",
"stripeChargeId": "<string>",
"stripeRefundId": "<string>",
"stripeAccountId": "<string>",
"connectChargeType": "DIRECT",
"failureCode": "<string>",
"failureMessage": "<string>",
"note": "<string>",
"disputeId": "<string>",
"disputeStatus": "needs_response",
"channel": "BACKOFFICE",
"reason": "<string>"
}
],
"nextCursor": "<string>"
}{
"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.
Path Parameters
Query Parameters
Maximum rows to return in data, 1–200. Defaults to 50. Values outside the range return 400. A page can still hold fewer rows than requested, so treat nextCursor: null as the only end-of-results signal and never stop on a page that merely looks short.
1 <= x <= 20050