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

get /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

The month, 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

Only what belongs to this seller: their ID (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

Customers live at the end of the last day of the month (right now, while the month runs): gone live by then, not cancelled by then and not suspended.

employees

integer

The employees those customers were signed up with.

users

integer

Their employees registered in the app, by each customer's latest numbers on or before that day.

signed

integer

Customers submitted in the month, whether or not they are live.

cancelled

integer

Customers cancelled in the month that had been live.

sellers

array of objects

The same numbers per seller, the seller with most live customers first. A seller is listed when they have a customer counted in live_customers or signed one in the month.

customers

array of objects

Every customer counted in live_customers, by company name from A to Z. Never paged.

Errors

401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no seller matches seller.
422 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.
429 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"
200 · Response
{
    "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.

Sending…

                    

List the last 12 months

get /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

Only what belongs to this seller: their ID (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

Always false: the list is never paged.

next_cursor

, nullable

Always null.

data

array of objects

Up to twelve months, oldest first.

Errors

401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: no seller matches seller.
422 validation_error: a seller filter is too long.
429 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"
200 · Response
{
    "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.

Sending…