API reference
Statement
Your month as Monotree counts it for the statement: live customers and their employees, per seller and per customer.
Base URL https://partners.monotree.com/api/v1
· every call needs a token
Get a month
/overview
customers:read Your customers in one month as Monotree counts them for the monthly statement: the customers live on the last day of the month, per seller and per customer. Months run on UTC. With format=csv (or the header Accept: text/csv) the customers come as a CSV file, the same one the portal exports. See The monthly statement.
Parameters
month
string · query
YYYY-MM. This month when left out. A month in the future, or before your first month with Monotree, answers 422.
format
string · query
csv for a spreadsheet of the customers instead of JSON. When left out, the header Accept: text/csv asks for the same.
one of json, csv · default json
seller
string · query
sel_12), or external_ref: followed by your own reference for them (external_ref:usr_20503). The same on every list that takes seller. A seller that does not exist answers 404.
Response · 200 The month. As CSV, a file named `monotree-YYYY-MM.csv` with one row for each customer in `customers`: UTF-8 (`text/csv; charset=utf-8`), starting with a byte order mark so that Excel reads it as such.
object
string
month
string
matches ^\d{4}-(0[1-9]|1[0-2])$
complete
boolean
true once the month is over (UTC). false for the month that runs: its numbers are as of now and still move.
live_customers
integer
employees
integer
users
integer
signed
integer
cancelled
integer
sellers
array of objects
live_customers or signed one in the month.
customers
array of objects
live_customers, by company name from A to Z. Never paged.
Errors
invalid_token: the token is missing, revoked or expired.
insufficient_ability: the token lacks the ability this call needs.
not_found: no seller matches seller.
validation_error: month is not written YYYY-MM, lies in the future or before your first month with Monotree, or format is not json or csv. fields names the parameter.
rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/overview \
-H "Authorization: Bearer $MONOTREE_TOKEN"$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://partners.monotree.com/api/v1/overview', [
'headers' => [
'Authorization' => 'Bearer '.getenv('MONOTREE_TOKEN'),
],
]);
$data = json_decode($response->getBody(), true);const response = await fetch('https://partners.monotree.com/api/v1/overview', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.MONOTREE_TOKEN}`,
},
});
const data = await response.json();import os
import requests
response = requests.get(
"https://partners.monotree.com/api/v1/overview",
headers={
"Authorization": f"Bearer {os.environ['MONOTREE_TOKEN']}",
},
)
data = response.json(){
"object": "overview",
"month": "2026-10",
"complete": true,
"live_customers": 39,
"employees": 894,
"users": 702,
"signed": 5,
"cancelled": 2,
"sellers": [
{
"seller": {
"id": "sel_12",
"name": "Emma Dubois",
"external_ref": "usr_20503"
},
"customers": 10,
"employees": 254,
"users": 208,
"signed": 1
}
],
"customers": [
{
"id": "cus_01jcz8w3k1x9q2v7s4e6m0b5n8",
"company_name": "Boulangerie Martin",
"company_id": "boulangeriemartin",
"external_ref": "org_48213",
"seller": {
"id": "sel_12",
"name": "Emma Dubois",
"external_ref": "usr_20503"
},
"live_at": "2026-07-09",
"employees": 9,
"users": 8
}
]
}
Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.
List the last 12 months
/overview/months
customers:read The last twelve months, oldest first and this month last: the customers live at the end of each month (right now, for the month that runs) and the customers signed in it. Up to twelve rows: only months Get a month answers for, so the list starts at your first month with Monotree when that is less than a year ago. Never paged: the usual list shape, with has_more always false. live_customers of a month is the same number as in Get a month.
Parameters
seller
string · query
sel_12), or external_ref: followed by your own reference for them (external_ref:usr_20503). The same on every list that takes seller. A seller that does not exist answers 404.
Response · 200 The months.
object
string
has_more
boolean
next_cursor
, nullable
data
array of objects
Errors
invalid_token: the token is missing, revoked or expired.
insufficient_ability: the token lacks the ability this call needs.
not_found: no seller matches seller.
validation_error: a seller filter is too long.
rate_limited: too many requests. The general limit is 120 requests a minute for all your tokens of one mode (live or sandbox) together, and 300 a minute per IP address before the token is checked. Some calls have a lower limit of their own, which counts only calls that did what they ask (a call refused with another error uses up no place); the Rate limits guide lists them. Wait for the number of seconds in the Retry-After header.
curl https://partners.monotree.com/api/v1/overview/months \
-H "Authorization: Bearer $MONOTREE_TOKEN"$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://partners.monotree.com/api/v1/overview/months', [
'headers' => [
'Authorization' => 'Bearer '.getenv('MONOTREE_TOKEN'),
],
]);
$data = json_decode($response->getBody(), true);const response = await fetch('https://partners.monotree.com/api/v1/overview/months', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.MONOTREE_TOKEN}`,
},
});
const data = await response.json();import os
import requests
response = requests.get(
"https://partners.monotree.com/api/v1/overview/months",
headers={
"Authorization": f"Bearer {os.environ['MONOTREE_TOKEN']}",
},
)
data = response.json(){
"object": "list",
"data": [
{
"month": "2025-12",
"live_customers": 0,
"signed": 0
},
{
"month": "2026-01",
"live_customers": 0,
"signed": 0
},
{
"month": "2026-02",
"live_customers": 0,
"signed": 0
},
{
"month": "2026-03",
"live_customers": 1,
"signed": 1
},
{
"month": "2026-04",
"live_customers": 5,
"signed": 4
},
{
"month": "2026-05",
"live_customers": 13,
"signed": 8
},
{
"month": "2026-06",
"live_customers": 19,
"signed": 6
},
{
"month": "2026-07",
"live_customers": 26,
"signed": 7
},
{
"month": "2026-08",
"live_customers": 32,
"signed": 6
},
{
"month": "2026-09",
"live_customers": 37,
"signed": 5
},
{
"month": "2026-10",
"live_customers": 39,
"signed": 5
},
{
"month": "2026-11",
"live_customers": 43,
"signed": 7
}
],
"has_more": false,
"next_cursor": null
}
Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.