List receive rulesets

​

List the rulesets owned by your account. Use subaccountId to select one direct child or includeSubaccounts=true to include your account and its direct children.

Query Parameters
  • subaccountId
    Type: string Format: uuid

    Scope this read to one of your subaccounts instead of the authenticated account. Must be a direct child of the authenticated account.

  • includeSubaccounts
    Type: string enum

    Set to true to include your subaccounts' records alongside your own. true cannot be combined with subaccountId; false can, and means the same as omitting it.

    values
    • true
    • false
  • status
    Type: string enum
    values
    • ACTIVE
    • INACTIVE
    • PENDING
    • FAILED
  • chain
    Type: string
    min length:  
    1
  • limit
    Type: integer
    min:  
    1
    max:  
    1000

    Integer numbers.

  • offset
    Type: integer
    min:  
    0
    max:  
    9007199254740991

    Integer numbers.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/api/v1/rulesets
curl https://api.bettermoney.com/api/v1/rulesets

{
  "rulesets": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "name": null,
      "status": "ACTIVE",
      "deliveredAsset": "string",
      "deliveredChain": "string",
      "toAddress": "string",
      "mode": "NETTED",
      "metadata": {},
      "addresses": [
        {
          "chain": "string",
          "failureReason": "string",
          "status": "PENDING",
          "address": null
        }
      ],
      "createdAt": "2026-09-04T20:22:27.425Z"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1,
  "hasMore": true
}

Default Response