:::endpoint GET /v1/admin/dashboard/attention Everything 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](/docs/api/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. ```bash 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 ```json { "data": [ { "object": "attention_item", "kind": "payout", "id": "po_fstetuykgm6h6rmw", "person": { "id": "usr_5khkg6cpf4k8m8ev", "name": "Lena Ferreira", "email": "lena.ferreira.461@example.com" }, "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 |