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

# Get deposit limits for a funding source

> Returns the authenticated user's current ACH debit limits and remaining capacity for this funding source.



## OpenAPI

````yaml https://platform.spritz.finance/openapi.json get /v1/funding-sources/{fundingSourceId}/deposit-limits
openapi: 3.0.3
info:
  title: Spritz Finance API
  version: 1.0.0
  description: API for the Spritz Finance platform with RFC 9457 error handling
servers:
  - url: https://platform.spritz.finance
    description: Production
  - url: https://sandbox.spritz.finance
    description: Sandbox
security: []
tags:
  - name: Users
    description: User management endpoints
  - name: Bank Accounts
    description: Manage bank accounts for off-ramp destinations
  - name: Bills
    description: Manage bill pay accounts
  - name: Cards
    description: Spritz-issued debit cards
  - name: Auto-Ramp Accounts
    description: Virtual bank accounts that automatically convert fiat deposits to crypto
  - name: Spritz App
    description: >-
      Endpoints used by the Spritz app and internal SDKs. Excluded from the
      public partner spec.
paths:
  /v1/funding-sources/{fundingSourceId}/deposit-limits:
    get:
      tags:
        - Funding Sources
      summary: Get deposit limits for a funding source
      description: >-
        Returns the authenticated user's current ACH debit limits and remaining
        capacity for this funding source.
      operationId: getV1Funding-sourcesByFundingSourceIdDeposit-limits
      parameters:
        - name: fundingSourceId
          in: path
          required: true
          schema:
            description: Opaque public funding source ID
            type: string
            example: fs_01JV7Q8M4Y8K6N2Z5P3R1T9W0X
      responses:
        '200':
          description: >-
            Current ACH debit limits and remaining capacity for the
            authenticated user on this funding source.
          content:
            application/json:
              schema:
                description: >-
                  Current ACH debit limits and remaining capacity for the
                  authenticated user on this funding source.
                type: object
                properties:
                  minimumDepositAmountUsd:
                    description: Minimum deposit principal amount before fees
                    type: string
                    example: '10.00'
                  transactionLimitUsd:
                    description: Maximum ACH debit amount per transaction
                    type: string
                    example: '750.00'
                  dailyLimitUsd:
                    description: >-
                      Maximum daily ACH debit volume. Deprecated: use
                      `limitsByPriority.normal.maxAmountUsd` for the amount that
                      can be deposited right now.
                    type: string
                    example: '1500.00'
                  dailyRemainingUsd:
                    description: >-
                      Remaining ACH debit capacity today across all limits.
                      Deprecated: use `limitsByPriority.normal.maxAmountUsd`.
                    type: string
                    example: '1400.00'
                  monthlyLimitUsd:
                    description: >-
                      Maximum monthly ACH debit volume. Deprecated: use
                      `limitsByPriority.normal.maxAmountUsd` for the amount that
                      can be deposited right now.
                    type: string
                    example: '5000.00'
                  monthlyRemainingUsd:
                    description: >-
                      Remaining ACH debit capacity this month across all limits.
                      Deprecated: use `limitsByPriority.normal.maxAmountUsd`.
                    type: string
                    example: '4900.00'
                  unsettledDepositLimit:
                    description: Maximum number of unsettled ACH debit deposits allowed
                    type: number
                    example: 1
                  unsettledDepositRemaining:
                    description: Remaining unsettled ACH debit deposit capacity
                    type: number
                    example: 1
                  exposure:
                    description: >-
                      Open-exposure standing for this user. Capacity frees up as
                      deposits clear the 60-day dispute window.
                    type: object
                    properties:
                      capUsd:
                        description: >-
                          Ceiling on the user's open exposure — deposits inside
                          the 60-day dispute window
                        type: string
                        example: '1500.00'
                      openUsd:
                        description: The user's current open exposure
                        type: string
                        example: '400.00'
                      remainingUsd:
                        description: Exposure capacity remaining before the cap
                        type: string
                        example: '1100.00'
                    required:
                      - capUsd
                      - openUsd
                      - remainingUsd
                  limitsByPriority:
                    description: >-
                      Deposit availability keyed by the `priority` value sent on
                      deposit creation. These blocks are computed by the same
                      evaluator that gates deposit creation — an amount within
                      `maxAmountUsd` will be accepted.
                    type: object
                    properties:
                      normal:
                        description: 'What a `priority: normal` deposit request will accept'
                        type: object
                        properties:
                          available:
                            description: >-
                              Whether a `priority: normal` deposit can be
                              created right now
                            type: boolean
                          minAmountUsd:
                            description: Minimum accepted deposit amount
                            type: string
                            example: '10.00'
                          maxAmountUsd:
                            description: >-
                              The largest single deposit amount accepted right
                              now — all limits folded in, with headroom for the
                              maximum fee already deducted. Build amount inputs
                              against this value.
                            type: string
                            example: '742.57'
                          reason:
                            description: Why deposits are unavailable; null when available
                            anyOf:
                              - type: string
                                nullable: true
                                enum:
                                  - minimum_deposit
                              - type: string
                                nullable: true
                                enum:
                                  - transaction_limit
                              - type: string
                                nullable: true
                                enum:
                                  - daily_limit
                              - type: string
                                nullable: true
                                enum:
                                  - monthly_limit
                              - type: string
                                nullable: true
                                enum:
                                  - unsettled_deposit_limit
                              - type: string
                                nullable: true
                                enum:
                                  - bank_unsettled_deposit_limit
                              - type: string
                                nullable: true
                                enum:
                                  - open_exposure
                              - type: string
                                nullable: true
                                enum:
                                  - aggregate_exposure
                              - type: string
                                nullable: true
                                enum:
                                  - new_user_admission_paused
                          suggestedAction:
                            description: >-
                              Suggested next step when unavailable; null
                              otherwise
                            anyOf:
                              - type: string
                                nullable: true
                                enum:
                                  - auto_ramp
                              - type: string
                                nullable: true
                                enum:
                                  - wait_for_settlement
                        required:
                          - available
                          - minAmountUsd
                          - maxAmountUsd
                          - reason
                          - suggestedAction
                      high:
                        description: 'What a `priority: high` deposit request will accept'
                        type: object
                        properties:
                          available:
                            description: >-
                              Whether a `priority: high` deposit can be created
                              right now
                            type: boolean
                          maxPortionUsd:
                            description: >-
                              The largest portion of a deposit eligible for
                              high-priority release, with headroom for the
                              maximum high-priority fee already deducted
                            type: string
                            example: '0.00'
                          reason:
                            description: >-
                              Why high priority is unavailable; null when
                              available
                            anyOf:
                              - type: string
                                nullable: true
                                enum:
                                  - not_available
                              - description: >-
                                  Machine-readable reason a deposit would
                                  currently be blocked
                                anyOf:
                                  - type: string
                                    enum:
                                      - minimum_deposit
                                  - type: string
                                    enum:
                                      - transaction_limit
                                  - type: string
                                    enum:
                                      - daily_limit
                                  - type: string
                                    enum:
                                      - monthly_limit
                                  - type: string
                                    enum:
                                      - unsettled_deposit_limit
                                  - type: string
                                    enum:
                                      - bank_unsettled_deposit_limit
                                  - type: string
                                    enum:
                                      - open_exposure
                                  - type: string
                                    enum:
                                      - aggregate_exposure
                                  - type: string
                                    enum:
                                      - new_user_admission_paused
                          suggestedAction:
                            description: >-
                              Suggested next step when unavailable; null
                              otherwise
                            anyOf:
                              - type: string
                                nullable: true
                                enum:
                                  - auto_ramp
                              - type: string
                                nullable: true
                                enum:
                                  - wait_for_settlement
                        required:
                          - available
                          - maxPortionUsd
                          - reason
                          - suggestedAction
                    required:
                      - normal
                      - high
                required:
                  - minimumDepositAmountUsd
                  - transactionLimitUsd
                  - dailyLimitUsd
                  - dailyRemainingUsd
                  - monthlyLimitUsd
                  - monthlyRemainingUsd
                  - unsettledDepositLimit
                  - unsettledDepositRemaining
                  - exposure
                  - limitsByPriority
        '401':
          description: Response for status 401
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    default: about:blank
                    description: A URI reference that identifies the problem type
                    type: string
                    example: urn:problem-type:auth:unauthorized
                  title:
                    description: A short, human-readable summary of the problem type
                    type: string
                    example: Unauthorized
                  status:
                    description: The HTTP status code
                    type: number
                    example: 401
                  detail:
                    description: A human-readable explanation specific to this occurrence
                    type: string
                    example: Bearer token required
                  instance:
                    description: A URI reference that identifies the specific occurrence
                    type: string
                  realm:
                    description: The authentication realm
                    type: string
                    example: API
                  scope:
                    description: The required scope for this resource
                    type: string
                    example: read:users
                required:
                  - title
                  - status
                additionalProperties: false
        '404':
          description: Response for status 404
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    default: about:blank
                    description: A URI reference that identifies the problem type
                    type: string
                  title:
                    description: A short, human-readable summary of the problem type
                    type: string
                  status:
                    description: The HTTP status code
                    type: number
                    example: 404
                  detail:
                    description: A human-readable explanation specific to this occurrence
                    type: string
                  instance:
                    description: A URI reference that identifies the specific occurrence
                    type: string
                  resourceType:
                    description: The type of resource that was not found
                    type: string
                    example: user
                  resourceId:
                    description: The identifier of the resource that was not found
                    type: string
                required:
                  - title
                  - status
                  - resourceType
                  - resourceId
                additionalProperties: false
        '500':
          description: Response for status 500
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    default: about:blank
                    description: A URI reference that identifies the problem type
                    type: string
                    example: urn:problem-type:auth:unauthorized
                  title:
                    description: A short, human-readable summary of the problem type
                    type: string
                    example: Unauthorized
                  status:
                    description: The HTTP status code
                    type: number
                    example: 400
                  detail:
                    description: A human-readable explanation specific to this occurrence
                    type: string
                  instance:
                    description: A URI reference that identifies the specific occurrence
                    type: string
                    example: /errors/1234567890
                  code:
                    description: >-
                      Machine-readable cause, present when exactly one thing
                      failed. Branch on this, never on `detail`, which is
                      human-facing copy and may change. For deposit limits the
                      vocabulary matches the `reason` values the limits API
                      returns pre-flight.
                    type: string
                    example: transaction_limit
                  field:
                    description: The offending request field, present alongside `code`.
                    type: string
                    example: amountUsd
                  retryable:
                    description: >-
                      Whether retrying the same request later may succeed
                      without changing its inputs.
                    type: boolean
                    example: true
                required:
                  - title
                  - status
                additionalProperties: false
      security:
        - bearerAuth: []
        - integratorJwt: []
        - hmacAuth: []
          integratorKey: []
          timestamp: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Cognito JWT token for regular user authentication
    integratorJwt:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Integrator JWT token (prefix: spr_) for frontend integrator
        authentication. Obtained via token exchange endpoint.
    hmacAuth:
      type: apiKey
      in: header
      name: X-Signature
      description: >-
        HMAC signature authentication for backend integrators.


        **Required Headers:**

        - X-Integrator-Key: Integrator API key (format: int_...)

        - X-Signature: HMAC signature (format: sha256={hex})

        - X-Timestamp: Unix timestamp in milliseconds

        - Authorization: Bearer {user-api-key}


        **Signature Algorithm:** HMAC-SHA256


        **Signature Format:** {timestamp}.{METHOD}.{path}.{bodyHash}

        - timestamp: Unix timestamp in milliseconds

        - METHOD: HTTP method in UPPERCASE (GET, POST, etc.)

        - path: Request path (e.g., /v1/transactions)

        - bodyHash: SHA256 hex digest of request body (empty string if no body)


        **Timestamp Tolerance:** ±5 minutes (300 seconds)


        **Example:**

        For POST /v1/transactions with body {"amount":100} and timestamp
        1234567890000:

        Payload: 1234567890000.POST./v1/transactions.{sha256(body)}

        Signature: sha256=abc123...
    integratorKey:
      type: apiKey
      in: header
      name: X-Integrator-Key
      description: 'Integrator API key (format: int_...) used with HMAC authentication'
    timestamp:
      type: apiKey
      in: header
      name: X-Timestamp
      description: >-
        Unix timestamp in milliseconds for replay attack prevention. Must be
        within 5 minutes of server time.

````