Retrieve a payout intent

GET/api/partner/payout_intents/{id}

Key scope: partner key

One intent by its id.

Path parameters

id stringrequired: poi_….

Errors

404 intent_unknown
401 partner_key_required
401 partner_key_invalid
403 ip_not_allowed
429 rate_limited
503 direct_deposit_disabled

All codes: Errors.

Request

curl "https://wallet.simpleeasytransactions.com/api/partner/payout_intents/<id>" \
  -H "Authorization: Bearer $SET_PARTNER_KEY"

Response 200

{ "object": "payout_intent", "id": "poi_…", "reference": "bounty-4471", "state": "open", "chain": "base", "address": "0x…", "destination": "bank", "payeeId": "pye_…", "amountUsdc": "250.00",
  "txHash": null, "sandbox": false, "createdAt": "2026-11-08T15:04:05.000Z", "updatedAt": "2026-11-08T15:04:05.000Z", "paidAt": null,
  "next": "Pay this address, then set the reference on the payment (POST /api/partner/references) to mark the intent paid." }