> ## Documentation Index
> Fetch the complete documentation index at: https://nevermined.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a group's Router-rail (crypto) spend

> Returns a group's crypto-rail spend from the router-payment ledger — the org/group counterpart to the buyer-scoped router payments list. Amounts are per-asset atomic units (token units are not additive across assets, and not comparable to the fiat/credit rails — the group budget tracks the card-rail cents cap separately). Requires a Nevermined API key, active organization membership, and the Premium tier or higher.



## OpenAPI

````yaml /api-reference/organizations-openapi.json get /organizations/{orgId}/analytics/groups/{groupId}/router-spend
openapi: 3.0.0
info:
  title: Nevermined Organizations API
  description: >-
    Manage a Nevermined organization programmatically — members, tiers, groups &
    budgets, treasury wallets, customers, webhooks, analytics, and
    agent-discovery surfaces.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox
  - url: https://api.live.nevermined.app/api/v1
    description: Live
security: []
tags:
  - name: Organizations
    x-group: General
    description: Organization settings, members & roles, and workspace context.
  - name: Organizations - Billing
    x-group: Billing
    description: Tiers, subscriptions, invoices, checkout, and the public tier catalog.
  - name: Groups
    x-group: Groups & Budgets
    description: Organization groups, per-group budgets, and shared payment methods.
  - name: Organizations - Wallets
    x-group: Wallets
    description: Custodial stablecoin treasury wallets.
  - name: Organizations - Customers
    x-group: Customers
    description: The white-label customer CRM (Enterprise).
  - name: Organizations - Analytics
    x-group: Analytics
    description: Revenue, MRR, usage, conversion, and per-member metrics.
  - name: Organizations - Webhooks
    x-group: Webhooks
    description: Outbound webhook subscriptions and deliveries.
  - name: Organizations - Activity
    x-group: Activity
    description: The organization activity feed.
  - name: Organizations - Realtime
    x-group: Realtime
    description: Realtime WebSocket secret management (Enterprise).
  - name: Invitations
    x-group: Invitations
    description: Invite people to an organization.
  - name: Organizations - Integration
    x-group: Agent Discovery
    description: >-
      Public agent-discovery surfaces (llms.txt, agentic-instructions.md,
      ai-catalog.json).
paths:
  /organizations/{orgId}/analytics/groups/{groupId}/router-spend:
    get:
      tags:
        - Organizations - Analytics
      summary: Get a group's Router-rail (crypto) spend
      description: >-
        Returns a group's crypto-rail spend from the router-payment ledger — the
        org/group counterpart to the buyer-scoped router payments list. Amounts
        are per-asset atomic units (token units are not additive across assets,
        and not comparable to the fiat/credit rails — the group budget tracks
        the card-rail cents cap separately). Requires a Nevermined API key,
        active organization membership, and the Premium tier or higher.
      operationId: OrganizationAnalyticsController_groupRouterSpend
      parameters:
        - name: orgId
          required: true
          in: path
          description: Organization ID
          schema:
            type: string
            example: org-abc123
        - name: groupId
          required: true
          in: path
          description: Group ID
          schema:
            example: grp-9f2a1c
            type: string
        - name: limit
          required: false
          in: query
          description: Maximum number of payments to return (1–1000).
          schema:
            example: 100
            type: number
        - name: to
          required: false
          in: query
          description: ISO-8601 end date (inclusive).
          schema:
            example: '2026-02-01T23:59:59.999Z'
            type: string
        - name: from
          required: false
          in: query
          description: ISO-8601 start date (inclusive). Omit for a 30-day window.
          schema:
            example: '2026-01-01T00:00:00.000Z'
            type: string
      responses:
        '200':
          description: The group's per-asset router-rail spend + recent payments
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupRouterSpendResponseDto'
        '401':
          description: Missing or invalid Nevermined API key
        '403':
          description: >-
            Caller is not an organization member, or the org is not on the
            Premium tier or higher
      security:
        - Authorization: []
components:
  schemas:
    GroupRouterSpendResponseDto:
      type: object
      properties:
        totalsByAsset:
          description: >-
            Per-asset spend totals. Token atomic units are NOT additive across
            assets, so totals are reported per (asset, network) rather than as
            one cross-asset number.
          type: array
          items:
            $ref: '#/components/schemas/GroupRouterSpendTotalDto'
        items:
          description: The group's most-recent router payments in the window.
          type: array
          items:
            $ref: '#/components/schemas/GroupRouterPaymentItemDto'
      required:
        - totalsByAsset
        - items
    GroupRouterSpendTotalDto:
      type: object
      properties:
        asset:
          type: string
          description: Asset symbol (e.g. USDC / EURC).
          example: USDC
        network:
          type: string
          description: Settlement network.
          example: base
        totalAmount:
          type: string
          description: Total spend in the asset's atomic units, serialised as a string.
          example: '5000000'
        paymentCount:
          type: number
          description: Number of router payments in this asset/network.
          example: 12
      required:
        - asset
        - network
        - totalAmount
        - paymentCount
    GroupRouterPaymentItemDto:
      type: object
      properties:
        id:
          type: string
          example: a1b2c3d4-...
        buyer:
          type: string
          description: On-chain payer address.
          example: 0xbuyer...
        protocol:
          type: string
          example: x402
        amount:
          type: string
          description: Charged amount in the asset's atomic units (string).
          example: '1000000'
        asset:
          type: string
          nullable: true
          example: USDC
        network:
          type: string
          example: base
        status:
          type: string
          description: Issued | Settled | Failed.
          example: Issued
        createdAt:
          type: string
          description: ISO-8601 timestamp.
          example: '2026-05-18T11:42:00.000Z'
      required:
        - id
        - buyer
        - protocol
        - amount
        - network
        - status
        - createdAt
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Create Delegation](/docs/api-reference/delegation/create-delegation.md)
- [Groups & Budgets](/docs/solutions/organizations/groups-and-budgets.md)
- [Create a per-currency budget for a group](/docs/api-reference/groups/create-a-per-currency-budget-for-a-group.md)
- [List a group's budgets (one per currency)](/docs/api-reference/groups/list-a-groups-budgets-one-per-currency.md)
- [Organization Wallets](/docs/solutions/organizations/wallets.md)
