GET
/v1/admin/dashboard/attentionEverything in the firm that is waiting for a person, in the order it has been waiting: payout requests to review and to pay, fraud flags, tickets handed to a person, and the affiliate program's payouts, applications and code requests. The same list as "Needs your attention" on the dashboard of the website.
Each kind is in the list only for someone who may open its own screen: payouts
with view_payouts, fraud with view_fraud, tickets with view_tickets, and
the affiliate kinds with view_affiliate_payouts or view_affiliates in a
firm that has the affiliate program. Someone who may open none of them gets an
empty list and an empty kinds, not an error.
Needs a firm. Our own staff name one with the Propper-Workspace header.
Request
| Parameter | Description |
|---|---|
kinds | Only these kinds, with commas between them. Left out means every kind this person may see |
q | Search, on the person's name or email, the item's own id, a ticket's subject, an IP, or a code |
sort | waiting_since, waiting longest first (the default), or -waiting_since, newest first |
limit | How many, see pagination |
starting_after | The next_cursor of the page before. A cursor only works with the sort it was handed out with |
The kinds are payout (requested, to review), payout_approved (approved, to
pay), fraud, ticket, affiliate_payout, affiliate_application and
code_request. A kind this person may not see narrows the list to nothing;
a kind that does not exist is refused.
curl "https://api.proppertrading.com/v1/admin/dashboard/attention?kinds=payout,fraud&limit=2" \
-H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
-H "Propper-Workspace: acme"
Response
{
"data": [
{
"object": "attention_item",
"kind": "payout",
"id": "po_fstetuykgm6h6rmw",
"person": {
"id": "usr_5khkg6cpf4k8m8ev",
"name": "Lena Ferreira",
"email": "[email protected]"
},
"title": null,
"detail": "PAB66460E7",
"amount": { "value": "802.00", "currency": "USD" },
"status": null,
"high": false,
"waiting_since": "2026-10-03T22:01:39+00:00",
"action_url": "/admin/payouts?selected=po_fstetuykgm6h6rmw"
},
{
"object": "attention_item",
"kind": "fraud",
"id": "fflag_zuucx5n665usqrdf",
"person": null,
"title": "Shared device",
"detail": "3 accounts",
"amount": null,
"status": null,
"high": true,
"waiting_since": "2026-10-04T02:38:51+00:00",
"action_url": "/admin/fraud?flag=fflag_zuucx5n665usqrdf"
}
],
"meta": {
"request_id": "req_01m509qa2bptsz7q7trrvgttfa",
"has_more": true,
"next_cursor": "eyJzIjoid2FpdGluZ19zaW5jZSIsInYiOiIyMDI2LTEwLTA0IDAyOjM4OjUxLjAwMDAwMCIsImsiOiJmcmF1ZCIsImlkIjoiZmZsYWdfenV1Y3g1bjY2NXVzcXJkZiJ9",
"waiting": 73,
"counts": {
"payout": 11,
"payout_approved": 4,
"fraud": 52,
"ticket": 6,
"affiliate_payout": 0,
"affiliate_application": 0,
"code_request": 0
},
"kinds": [
"payout",
"payout_approved",
"fraud",
"ticket",
"affiliate_payout",
"affiliate_application",
"code_request"
]
}
}
| Field | Description |
|---|---|
kind | Which of the kinds above |
id | The item's own id: a payout request, a fraud flag, a ticket, an affiliate payout, an affiliate or a code request |
person | Who it is about, or null for a fraud flag about several accounts |
person.id | Their id, only when they are a trader of this firm and this person may open traders. Null otherwise |
title | A ticket's subject, a fraud flag's detector, or a requested code. Null for the other kinds |
detail | A payout's trading account, or "3 accounts" for a fraud flag about a group |
amount | What is asked for a payout to review, what goes out for one to pay, and an affiliate payout's amount. value is a string with two decimals |
status | An affiliate payout's status, pending or approved. Null for the other kinds |
high | A fraud flag that restricts or blocks, or is of high severity, and a ticket of high or urgent priority |
waiting_since | When it started waiting: requested, approved, flagged, or the trader's last message on a ticket |
action_url | Where the website shows it, a path inside the web application like a notification's action_url |
meta.waiting | Everything waiting for this person, whatever the list is narrowed to. The number a greeting says |
meta.counts | How many of each kind this person may see, matching q but not kinds, so a filter can say what a choice would show |
meta.kinds | The kinds this person may see, in the order the website's filter lists them |
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | workspace_required | Asked by our own staff without naming a firm |
| 400 | invalid_kind | A kind in kinds that does not exist |
| 400 | invalid_sort | sort is not waiting_since or -waiting_since |
| 400 | invalid_limit | limit is not a positive integer |
| 400 | invalid_cursor | starting_after is not a cursor handed out for this sort |
| 401 | invalid_token | Not a token, or the secret does not match |
| 401 | revoked_token | Signed out here or from another device |
| 401 | expired_token | Ninety days without use, or a set expiry passed |
| 403 | admin_access_required | This account no longer helps run the environment |
| 403 | insufficient_scope | This device does not hold admin:read |
| 403 | workspace_not_permitted | The Propper-Workspace header names an environment this account cannot act in |