Skip to main content
GET
/
users
/
me
/
wallets
List my wallets
curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/users/me/wallets
Returns the authenticated member’s wallets. The subject is resolved from the access token, so there is no member ID in the path. Each member has a MEMBERSHIP wallet and a SPENDING wallet, both auto-provisioned on their first OAuth completion.
Tasting note - Wallets are not paginated. The response is a simple { "wallets": [...] } array.
Auth: OAuth access token with the read:wallets scope. A token missing that scope returns 403 with error="insufficient_scope" in the WWW-Authenticate header.

Example

curl https://api.staging.blackbird.xyz/flynet/v1/users/me/wallets \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

{
  "wallets": [
    {
      "id": "{uuid}",
      "object": "user_wallet",
      "wallet_type": "MEMBERSHIP",
      "address": "0xaF8A2609EEaf253838E90353881987d8218c8056",
      "created_at": "2026-05-11T20:21:07.812609Z",
      "updated_at": "2026-05-11T20:21:07.812621Z"
    },
    {
      "id": "{uuid}",
      "object": "user_wallet",
      "wallet_type": "SPENDING",
      "address": "0x0DC3837d4Ec7732733fD72736279B365DbC10229",
      "created_at": "2026-05-11T20:21:07.824437Z",
      "updated_at": "2026-05-11T20:21:07.824449Z"
    }
  ]
}