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
/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
default 25 · up to 100
cursor
string · query
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
next_cursor
string, nullable
cursor for the next page.
data
array of objects
Errors
invalid_cursor: the cursor is not one this API gave out.
invalid_token: the token is missing, revoked or expired.
insufficient_ability: the token lacks the ability this call needs.
validation_error: limit is not 1 to 100.
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"$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://partners.monotree.com/api/v1/security/people', [
'headers' => [
'Authorization' => 'Bearer '.getenv('MONOTREE_TOKEN'),
],
]);
$data = json_decode($response->getBody(), true);const response = await fetch('https://partners.monotree.com/api/v1/security/people', {
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/security/people",
headers={
"Authorization": f"Bearer {os.environ['MONOTREE_TOKEN']}",
},
)
data = response.json(){
"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.
List the sign-in log
/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
default 25 · up to 100
cursor
string · query
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
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
Response · 200 A page of the sign-in log.
object
string
has_more
boolean
next_cursor
string, nullable
cursor for the next page.
data
array of objects
Errors
invalid_cursor: the cursor is not one this API gave out.
invalid_token: the token is missing, revoked or expired.
insufficient_ability: the token lacks the ability this call needs.
not_found: seller names nobody in the mode of the token.
validation_error: show is not one of its values, after is not a time, or limit is not 1 to 100.
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"$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://partners.monotree.com/api/v1/security/events', [
'headers' => [
'Authorization' => 'Bearer '.getenv('MONOTREE_TOKEN'),
],
]);
$data = json_decode($response->getBody(), true);const response = await fetch('https://partners.monotree.com/api/v1/security/events', {
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/security/events",
headers={
"Authorization": f"Bearer {os.environ['MONOTREE_TOKEN']}",
},
)
data = response.json(){
"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.