GET
/
wallets
List wallets owned by an organization or associated with a plan
curl --request GET \
  --url https://api.paygentic.io/v0/wallets \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "wallet",
      "ownedBy": "<string>",
      "namespace": "<string>",
      "balance": 123,
      "currency": "<string>",
      "timezone": "<string>",
      "tag": "<string>",
      "createdAt": 123,
      "updatedAt": 123,
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "hasMore": true,
  "nextPageToken": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication

Query Parameters

ownedBy
string

Organization ID that owns the wallets (required if namespace is not provided, or required when using planId filter)

namespace
string

Namespace to filter wallets by (required if ownedBy is not provided)

planId
string

Filter wallets by plan ID. Returns wallets associated with the specified plan (requires ownedBy parameter)

pageSize
integer
default:10

Number of wallets to return per page

Required range: 1 <= x <= 100
pageToken
string

Token for pagination

Response

List of wallets

object
enum<string>
required
Available options:
list
data
object[]
required
hasMore
boolean
required

Whether there are more wallets to fetch

nextPageToken
string
required

Token to fetch next page, empty if no more pages