API reference

Security

How your people sign in to the portal: two-factor sign-in, passkeys and the sign-in log.

Base URL https://partners.monotree.com/api/v1 · every call needs a token

List who can sign in

get /security/people security:read

Your people who have a password and are not disabled, each with their two-factor sign-in, passkeys, last sign-in and wrong tries. Newest first by when they were added. Test sellers never sign in, so a sandbox token gets an empty list. See Security and sign-in.

Parameters

limit

integer · query

How many to return in a page, 1 to 100.

default 25 · up to 100

cursor

string · query

The next_cursor of the page before, for the next page. Send the same filters with it.
Response · 200 A page of people.

object

string

has_more

boolean

Whether there is a page after this one.

next_cursor

string, nullable

Pass as cursor for the next page.

data

array of objects

Errors

400 invalid_cursor: the cursor is not one this API gave out.
401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
422 validation_error: limit is not 1 to 100.
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/security/people \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "object": "list",
    "data": [
        {
            "object": "security_person",
            "seller": {
                "id": "sel_5",
                "name": "Emma Dubois",
                "email": "emma@acme.example",
                "external_ref": "usr_20503",
                "role": "seller"
            },
            "two_factor": true,
            "passkeys": 0,
            "last_sign_in": {
                "at": "2026-11-14T12:41:59Z",
                "device": "Chrome on macOS",
                "ip": "203.0.113.7",
                "via": "password"
            },
            "failed_7d": 0,
            "dormant": false
        }
    ],
    "has_more": true,
    "next_cursor": "6Yb0mT9wQ3F7ImlkIjo1fQ"
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…

                    

List the sign-in log

get /security/events security:read

Sign-ins, sign-outs, wrong tries and changes to how someone signs in, newest first. Kept 180 days. These are not the events your webhook endpoints get: the sign-in log is only read here. A sandbox token gets an empty list.

Parameters

limit

integer · query

How many to return in a page, 1 to 100.

default 25 · up to 100

cursor

string · query

The next_cursor of the page before, for the next page. Send the same filters with it.

show

string · query

denied for attempts that did not get in (login.failed, login.lockout, two_factor.failed), changes for changes to how someone signs in (password.reset, password.changed, two_factor.confirmed, two_factor.disabled, two_factor.reset, two_factor.recovery_code_used, two_factor.recovery_codes_generated, passkey.added, passkey.removed).

one of all, denied, changes · default all

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.

created_after

string · query

Only lines later than this time, to fetch only what is new.
Response · 200 A page of the sign-in log.

object

string

has_more

boolean

Whether there is a page after this one.

next_cursor

string, nullable

Pass as cursor for the next page.

data

array of objects

Errors

400 invalid_cursor: the cursor is not one this API gave out.
401 invalid_token: the token is missing, revoked or expired.
403 insufficient_ability: the token lacks the ability this call needs.
404 not_found: seller names nobody in the mode of the token.
422 validation_error: show is not one of its values, after is not a time, or limit is not 1 to 100.
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/security/events \
  -H "Authorization: Bearer $MONOTREE_TOKEN"
200 · Response
{
    "object": "list",
    "data": [
        {
            "id": "sev_83",
            "object": "security_event",
            "type": "two_factor.confirmed",
            "label": "Two-factor sign-in turned on",
            "denied": false,
            "seller": {
                "id": "sel_5",
                "name": "Emma Dubois",
                "external_ref": "usr_20503"
            },
            "device": "Chrome on macOS",
            "ip": "203.0.113.7",
            "created_at": "2026-11-14T12:43:36Z"
        },
        {
            "id": "sev_82",
            "object": "security_event",
            "type": "login",
            "label": "Signed in",
            "denied": false,
            "seller": {
                "id": "sel_5",
                "name": "Emma Dubois",
                "external_ref": "usr_20503"
            },
            "device": "Chrome on macOS",
            "ip": "203.0.113.7",
            "created_at": "2026-11-14T12:41:59Z"
        }
    ],
    "has_more": true,
    "next_cursor": "Kq2xV8dLm1N7ImlkIjo4Mn0"
}

Only mpt_test_… tokens work here; nothing reaches a real customer. Kept in this browser tab only.

Sending…