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

# Accounts



## OpenAPI

````yaml /api-reference/openapi.json get /v1/accounts
openapi: 3.0.4
info:
  description: >-
    Public API for the StableMint platform. Every request is authenticated with
    a service-account RSA signature over a canonical string; bearer tokens are
    not accepted.
  title: StableMint API
  version: v1
servers:
  - description: Production
    url: https://api.stablemint.io
  - description: Sandbox
    url: https://api.stablemint.net
security: []
tags:
  - name: accounts
  - name: beneficiaries
  - name: checkout
  - name: customers
  - name: fx
  - name: payouts
  - name: reports
  - name: simulations
  - name: transactions
  - name: users
  - name: wallets
  - name: webhooks
paths:
  /v1/accounts:
    get:
      tags:
        - accounts
      summary: Accounts
      operationId: accounts
      parameters:
        - in: query
          name: startDate
          schema:
            format: date-time
            type: string
        - in: query
          name: endDate
          schema:
            format: date-time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/PartnerAccountOverviewResponse'
                type: array
          description: OK
        '400':
          description: Malformed request
        '401':
          description: >-
            No service-account credentials (code: signature_required), a Clerk
            bearer token was sent (code: jwt_not_accepted) — both rejected by
            the gateway — or the RSA signature, timestamp window or nonce failed
            verification downstream.
        '403':
          description: >-
            Authenticated but lacking the required permission, or an
            impersonated session attempting a write (code:
            impersonation_write_blocked).
        '404':
          description: >-
            No such resource. Also returned by the gateway itself when a path
            parameter fails its route constraint.
        '500':
          description: Unhandled downstream error
        '502':
          description: >-
            Gateway could not reach the downstream service or received an
            invalid response from it.
        '504':
          description: Downstream service did not respond in time.
      security:
        - ApiKey: []
          Nonce: []
          Signature: []
          Timestamp: []
components:
  schemas:
    PartnerAccountOverviewResponse:
      properties:
        accountHolder:
          type: string
        balance:
          $ref: '#/components/schemas/AccountBalanceResponse'
        bankName:
          type: string
        currency:
          type: string
        customerActivity:
          $ref: '#/components/schemas/CustomerActivityResponse'
        iban:
          type: string
        totalBalance:
          format: double
          type: number
      required:
        - currency
        - accountHolder
        - bankName
        - iban
        - totalBalance
        - balance
        - customerActivity
      type: object
    AccountBalanceResponse:
      properties:
        businessBalance:
          format: double
          type: number
        customerBalance:
          format: double
          type: number
        netDeposit:
          format: double
          type: number
        totalDeposits:
          format: double
          type: number
        totalWithdrawals:
          format: double
          type: number
      required:
        - netDeposit
        - totalDeposits
        - totalWithdrawals
        - customerBalance
        - businessBalance
      type: object
    CustomerActivityResponse:
      properties:
        customerBalance:
          format: double
          type: number
        depositAverage:
          format: double
          type: number
        depositTotal:
          format: double
          type: number
        depositTrend:
          format: double
          type: number
        depositWithdrawalRatio:
          format: double
          type: number
        netDepositTrend:
          format: double
          type: number
        withdrawalAverage:
          format: double
          type: number
        withdrawalTotal:
          format: double
          type: number
        withdrawalTrend:
          format: double
          type: number
      required:
        - customerBalance
        - depositWithdrawalRatio
        - netDepositTrend
        - depositTotal
        - depositAverage
        - depositTrend
        - withdrawalTotal
        - withdrawalAverage
        - withdrawalTrend
      type: object
  securitySchemes:
    ApiKey:
      description: The service account's API key.
      in: header
      name: ApiKey
      type: apiKey
    Nonce:
      description: A GUID, single-use. A replayed nonce is rejected.
      in: header
      name: Nonce
      type: apiKey
    Signature:
      description: >-
        Base64 RSA/SHA-256 (PKCS#1 v1.5) signature over the canonical string:
        METHOD, path, canonical query, Timestamp, Nonce, API secret and the
        lowercase hex SHA-256 of the raw body, joined with LF. Sign the PUBLIC
        path exactly as called (e.g. /v1/webhooks), not any internal path.
      in: header
      name: Signature
      type: apiKey
    Timestamp:
      description: Unix seconds. Rejected outside the server's tolerance window.
      in: header
      name: Timestamp
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.