GET /api/dashboard — Dashboard Summary Data

The dashboard endpoint is your single entry point for building a complete account overview. One authenticated request returns seven data points — wallet balances, recent transactions, active AI sessions, pending approval requests, spending policies, monthly usage records, and per-session daily budget consumption. Rather than making seven separate API calls and stitching the results together on the client, you can use this endpoint to populate an entire dashboard UI in a single round trip.

This endpoint is purpose-built for dashboard UIs. All seven data sources are fetched concurrently on the server, so the total response time is bounded by the slowest individual source — not the sum of all seven. Use it wherever you need a full account snapshot and want to minimize network overhead.

Endpoint

GET /api/dashboard

Authentication

All requests must include a valid bearer token in the Authorization header, or a pay3_session cookie obtained during wallet authentication.

Authorization: Bearer <token>

Response fields

object

required

Wallet identity and live Stellar asset balances for your primary wallet.

Show wallet fields

object

required

Core wallet metadata.

Show wallet.wallet fields

string

required

UUID of the wallet record.

string

required

Stellar G-address (public key) for this wallet.

string

required

Stellar network this wallet operates on. One of TESTNET or PUBLIC.

boolean

required

Whether this is the account’s designated primary wallet.

array

required

Live asset balances fetched directly from the Stellar network at request time. Each entry represents one asset held by the wallet.

Show balances[] fields

string

required

Asset code (e.g. "USDC", "XLM").

string

required

Current balance as a decimal string (e.g. "250.0000000").

string

required

Stellar asset type. One of native (XLM) or credit_alphanum4 / credit_alphanum12 for issued assets.

array

required

Soroban smart account contracts linked to this wallet.

Show smartAccounts[] fields

string

required

UUID of the smart account record.

string

required

On-chain Soroban contract ID (C-address).

string

required

Stellar network the contract is deployed on.

string

required

ISO 8601 timestamp when the smart account was created.

array

required

The 10 most recent transactions across your account, ordered newest first.

Show recentTransactions[] fields

string

required

UUID of the transaction record.

string

required

Operation type. One of TRANSFER, CHECK_BALANCE, or VIEW_TRANSACTION_HISTORY.

string

required

Transaction lifecycle status. One of CREATED, VALIDATING, AUTO_APPROVED, PENDING_APPROVAL, APPROVED, SIGNING, SUBMITTING, SUCCESS, FAILED, REJECTED, EXPIRED, or CANCELLED.

string

Transfer amount as a decimal string. null for non-transfer actions.

string

required

Asset code (e.g. "USDC").

string

Resolved Stellar G-address of the recipient. null for non-transfer actions.

string

On-chain transaction hash. Present only after the transaction has reached SUCCESS.

object

The AI session that initiated this transaction.

Show aiSession fields

string

required

UUID of the AI session.

string

required

AI client that created this session (e.g. "CURSOR", "CLAUDE").

object

The resolved contact for this transaction’s recipient, if the address matched a saved contact. null if no match was found.

Show contact fields

string

required

UUID of the contact record.

string

required

Human-readable name of the contact.

string

required

ISO 8601 timestamp when the transaction record was created.

array

required

All currently active AI sessions on your account — sessions with status ACTIVE and a future expiresAt.

Show activeSessions[] fields

string

required

UUID of the AI session.

string

required

AI client associated with this session. One of CURSOR, CLAUDE, CHATGPT, GEMINI, or OTHER.

string

required

UUID of the smart account this session is authorized to operate on.

string

required

UUID of the spending policy governing this session’s transaction limits.

string

required

Session status — ACTIVE for all entries in this array.

string

required

ISO 8601 timestamp when this session will automatically expire.

string

required

ISO 8601 timestamp when the session was created.

array

required

All approval requests currently awaiting your review — requests with status PENDING and a future expiresAt.

Show pendingApprovals[] fields

string

required

UUID of the approval request.

string

required

Always PENDING for entries returned here.

string

required

UUID of the transaction awaiting approval.

string

required

ISO 8601 timestamp after which this approval request expires and can no longer be actioned.

object

required

Full transaction record for the payment being requested.

Show transaction fields

string

required

UUID of the transaction.

string

required

Always TRANSFER for transactions that require approval.

string

required

Requested transfer amount as a decimal string.

string

required

Asset code to be transferred.

string

required

Recipient’s Stellar G-address.

string

required

Transaction status — PENDING_APPROVAL for all entries in this context.

object

required

The AI session that triggered this approval request.

Show aiSession fields

string

required

UUID of the AI session.

string

required

AI client that initiated the transaction.

string

required

ISO 8601 timestamp when the approval request was created.

array

required

All active spending policies on your account, ordered newest first.

Show policies[] fields

string

required

UUID of the policy.

string

required

Human-readable name you gave this policy.

string

required

Policy preset used as the starting configuration. One of CONSERVATIVE, BALANCED, DEFI, or CUSTOM.

string

required

Maximum total spend per day across all sessions using this policy, as a decimal string (USD).

string

Monthly spend cap in USD as a decimal string, or null if no monthly limit is set.

string

required

Maximum amount for a single transaction, as a decimal string (USD).

string

required

Transactions above this amount (USD) require manual approval before submission.

number

required

Maximum lifetime in hours for any session created under this policy.

array

required

List of asset codes this policy permits (e.g. ["USDC", "XLM"]).

array

required

List of actions permitted under this policy. Values include CHECK_BALANCE, TRANSFER, and VIEW_TRANSACTION_HISTORY.

array

required

List of contact UUIDs that sessions under this policy may send to. An empty array means no recipient restriction is enforced.

number

Maximum transactions per minute. null if no rate limit is set.

boolean

required

Whether this policy is currently active. Only active policies appear in this array.

string

required

ISO 8601 timestamp when the policy was created.

string

required

ISO 8601 timestamp when the policy was last modified.

object

required

Aggregated spend records for the current calendar month, broken down by AI session and asset.

Show monthlyUsage fields

object

required

The billing period these records cover.

Show period fields

number

required

Four-digit calendar year (e.g. 2025).

number

required

Calendar month as an integer from 1 (January) to 12 (December).

array

required

Individual usage records, each representing spend for one session-and-asset combination.

Show records[] fields

string

required

UUID of the AI session this record belongs to.

string

required

Asset code for this usage record (e.g. "USDC").

string

required

Total amount transacted in this asset during the period, as a decimal string.

number

required

Number of transactions contributing to totalAmount.

object

required

Aggregated totals rolled up across all sessions, keyed by uppercase asset code.

Show totalsByAsset example

{
  "USDC": { "totalAmount": "320.50", "transactionCount": 7 },
  "XLM":  { "totalAmount": "45.00",  "transactionCount": 2 }
}

object

required

Real-time daily and monthly budget consumption for every currently active AI session.

Show budgetUsage fields

array

required

One entry per active session. An empty array is returned if no sessions are currently active.

Show sessions[] fields

string

required

UUID of the active AI session.

string

required

AI client type for this session (e.g. "CURSOR").

string

required

UUID of the smart account this session is authorized to operate on.

object

required

Spending limits in effect for this session.

Show policy fields

string

required

Daily spend cap in USD as a decimal string.

string

Monthly spend cap in USD, or null if no monthly limit is set.

array

required

Asset codes this session is permitted to transfer.

array

required

Amount spent today (UTC day) broken down by asset.

Show dailySpent[] fields

string

required

Asset code (e.g. "USDC").

string

required

Amount spent today in this asset, as a decimal string.

array

required

Amount spent in the current calendar month broken down by asset.

Show monthlySpent[] fields

string

required

Asset code (e.g. "USDC").

string

required

Amount spent this month in this asset, as a decimal string.

Example request

curl https://api.pay3.dev/api/dashboard \
  -H "Authorization: Bearer <token>"

Example response

{
  "wallet": {
    "wallet": {
      "id": "w1a2b3c4-0001-4abc-8def-000000000001",
      "publicAddress": "GDQP2KPQGKIHYJGXNUIYOMHARUARCA7DJT5FO2FFOOKY3B2WSQHG4W37",
      "network": "PUBLIC",
      "isPrimary": true
    },
    "balances": [
      {
        "asset": "USDC",
        "balance": "1250.0000000",
        "assetType": "credit_alphanum4"
      },
      {
        "asset": "XLM",
        "balance": "98.4321000",
        "assetType": "native"
      }
    ],
    "smartAccounts": [
      {
        "id": "sa1a2b3c4-0001-4abc-8def-000000000010",
        "contractId": "CCJZ5DGASBWQXR5MPFCJXMBI5HONGSDJFQNZOQQVLRBTKMJZFJBTMKYT",
        "network": "PUBLIC",
        "createdAt": "2025-05-01T09:00:00.000Z"
      }
    ]
  },
  "recentTransactions": [
    {
      "id": "tx1a2b3c4-0001-4abc-8def-000000000020",
      "action": "TRANSFER",
      "status": "SUCCESS",
      "amount": "50.00",
      "asset": "USDC",
      "recipientAddress": "GBVFEQKQ5VGHIH4CVXOL5TXIVMS6OJQMQHM5LLNTV3AAJHID5OFWKM4",
      "stellarTransactionHash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
      "aiSession": {
        "id": "sess1a2b3c4-0001-4abc-8def-000000000030",
        "clientType": "CURSOR"
      },
      "contact": {
        "id": "c1a2b3d4-0001-4abc-8def-000000000001",
        "displayName": "Alice Johnson"
      },
      "createdAt": "2025-07-08T14:30:00.000Z"
    }
  ],
  "activeSessions": [
    {
      "id": "sess1a2b3c4-0001-4abc-8def-000000000030",
      "clientType": "CURSOR",
      "smartAccountId": "sa1a2b3c4-0001-4abc-8def-000000000010",
      "policyId": "pol1a2b3c4-0001-4abc-8def-000000000040",
      "status": "ACTIVE",
      "expiresAt": "2025-07-15T14:30:00.000Z",
      "createdAt": "2025-07-08T14:30:00.000Z"
    }
  ],
  "pendingApprovals": [
    {
      "id": "apr1a2b3c4-0001-4abc-8def-000000000050",
      "status": "PENDING",
      "transactionId": "tx1a2b3c4-0002-4abc-8def-000000000021",
      "expiresAt": "2025-07-09T14:32:00.000Z",
      "transaction": {
        "id": "tx1a2b3c4-0002-4abc-8def-000000000021",
        "action": "TRANSFER",
        "amount": "200.00",
        "asset": "USDC",
        "recipientAddress": "GBVFEQKQ5VGHIH4CVXOL5TXIVMS6OJQMQHM5LLNTV3AAJHID5OFWKM4",
        "status": "PENDING_APPROVAL"
      },
      "aiSession": {
        "id": "sess1a2b3c4-0001-4abc-8def-000000000030",
        "clientType": "CURSOR"
      },
      "createdAt": "2025-07-08T16:00:00.000Z"
    }
  ],
  "policies": [
    {
      "id": "pol1a2b3c4-0001-4abc-8def-000000000040",
      "name": "Daily Ops",
      "preset": "BALANCED",
      "dailyBudget": "500.0000000",
      "monthlyBudget": null,
      "perTransactionMax": "100.0000000",
      "manualApprovalThreshold": "250.0000000",
      "sessionDurationHours": 168,
      "allowedAssets": ["USDC", "XLM"],
      "allowedActions": [
        "CHECK_BALANCE",
        "TRANSFER",
        "VIEW_TRANSACTION_HISTORY"
      ],
      "allowedRecipientIds": [
        "c1a2b3d4-0001-4abc-8def-000000000001"
      ],
      "rateLimitPerMinute": null,
      "isActive": true,
      "createdAt": "2025-05-10T10:00:00.000Z",
      "updatedAt": "2025-05-10T10:00:00.000Z"
    }
  ],
  "monthlyUsage": {
    "period": {
      "year": 2025,
      "month": 7
    },
    "records": [
      {
        "aiSessionId": "sess1a2b3c4-0001-4abc-8def-000000000030",
        "asset": "USDC",
        "totalAmount": "320.50",
        "transactionCount": 7
      }
    ],
    "totalsByAsset": {
      "USDC": {
        "totalAmount": "320.50",
        "transactionCount": 7
      }
    }
  },
  "budgetUsage": {
    "sessions": [
      {
        "sessionId": "sess1a2b3c4-0001-4abc-8def-000000000030",
        "clientType": "CURSOR",
        "smartAccountId": "sa1a2b3c4-0001-4abc-8def-000000000010",
        "policy": {
          "dailyBudget": "500.0000000",
          "monthlyBudget": null,
          "allowedAssets": ["USDC", "XLM"]
        },
        "dailySpent": [
          {
            "asset": "USDC",
            "spentAmount": "50.00"
          }
        ],
        "monthlySpent": [
          {
            "asset": "USDC",
            "spentAmount": "320.50"
          }
        ]
      }
    ]
  }
}

Authentication

Wallet & Accounts

Sessions & Policies

Transactions

Contacts & Analytics

GET /api/dashboard — Dashboard Summary Data

Endpoint

Authentication

Response fields

Example request

Example response

​Endpoint

​Authentication

​Response fields

​Example request

​Example response

Endpoint

Authentication

Response fields

Example request

Example response