A payout: activity

.md

What happened to a payout, from the activity log, newest first.

Scopesadmin:read
Permissionview_payoutsview_activity_logs
GET/v1/admin/payouts/{payout}/activity

The tab Activity of the website's Payouts screen: the trader asking, every decision and who took it, the payment with its reference, the team's notes, and every change, newest first, up to sixty. What Propper's own staff did is left out, as the Activity log leaves it out.

Needs a firm. Our own staff name one with the Propper-Workspace header.

Request

curl "https://api.proppertrading.com/v1/admin/payouts/po_pk2jjt25cw5swbwv/activity" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Propper-Workspace: acme"

Response

{
    "data": [
        {
            "object": "activity",
            "id": "alog_3w2kujf4wjaqfjp8",
            "event": null,
            "description": "Marked payout #BGKST3 as paid ($599.25), reference SEPA 2026-10-15 0042",
            "user": {
                "id": "usr_pj68ba8tmrbb7fxb",
                "name": "Ios Tester",
                "email": "[email protected]"
            },
            "created_at": "2026-10-15T21:19:47+00:00"
        },
        {
            "object": "activity",
            "id": "alog_fwvpa4cajy9g6ne3",
            "event": "payout_request.updated",
            "description": "Updated payout request: #BGKST3",
            "user": {
                "id": "usr_pj68ba8tmrbb7fxb",
                "name": "Ios Tester",
                "email": "[email protected]"
            },
            "created_at": "2026-10-15T21:19:47+00:00"
        }
    ],
    "meta": {
        "request_id": "req_01m50qheqby74bhkh5jfxywnwf",
        "has_more": false,
        "next_cursor": null
    }
}
FieldDescription
eventWhat kind of change, such as payout_request.updated. Null for an entry written in words alone
descriptionWhat happened, in words
userWho did it. Null for the system

Errors

StatusCodeMeaning
400workspace_requiredAsked by our own staff without naming a firm
401invalid_tokenNot a token, or the secret does not match
401revoked_tokenSigned out here or from another device
401expired_tokenNinety days without use, or a set expiry passed
403admin_access_requiredThis account no longer helps run the environment
403insufficient_scopeThis device does not hold admin:read
403workspace_not_permittedThe Propper-Workspace header names an environment this account cannot act in
403forbiddenWithout view_payouts and view_activity_logs
404resource_not_foundNo payout with that id in this firm