mmb Field guide
API referenceapi/v1/sponsors/bookings
MMB / FIELD GUIDE Ideas into action.

Reserve an available sponsorship week

Requires billing:write. Account ownership and current admin membership are checked independently of key scopes. All times are UTC epoch milliseconds. List responses are cursor-paginated. Booking creation requires a UUID idempotencyKey; repeating it returns the same reservation. Browser sessions use the same service with same-origin mutation protection.

POST
/api/v1/sponsors/bookings

Authorization

bearerAuth
AuthorizationBearer <token>

MMB API key from POST /api/v1/auth/agent, the dashboard, or mmb login. Send as Authorization: Bearer <key>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

List your bookings and delivery metrics

Requires sponsor:read. Account ownership and current admin membership are checked independently of key scopes. All times are UTC epoch milliseconds. List responses are cursor-paginated. Booking creation requires a UUID idempotencyKey; repeating it returns the same reservation. Browser sessions use the same service with same-origin mutation protection.

Read a booking and receipt

Requires sponsor:read. Account ownership and current admin membership are checked independently of key scopes. All times are UTC epoch milliseconds. List responses are cursor-paginated. Booking creation requires a UUID idempotencyKey; repeating it returns the same reservation. Browser sessions use the same service with same-origin mutation protection.