> ## 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' 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: type: string enum: - minimum_deposit - transaction_limit - daily_limit - monthly_limit - unsettled_deposit_limit - unsettled_amount_limit - bank_unsettled_deposit_limit - open_exposure - aggregate_exposure - new_user_admission_paused - rail_halted - null description: Why deposits are unavailable; null when available nullable: true suggestedAction: type: string enum: - auto_ramp - wait_for_settlement - null description: >- Suggested next step when unavailable; null otherwise nullable: true clearsAt: format: date-time type: string description: >- Earliest instant the current `reason` can stop applying, or null when it is not time-bound. Derived from the same state that produced `reason`; another limit may bind after it, so re-fetch before submitting. nullable: true example: '2026-08-24T15:00:00.000Z' clearsAtIsEstimate: description: >- True when `clearsAt` is a forecast (expected ACH settlement, exposure ageing out) rather than a fixed boundary such as a daily window reset. type: boolean required: - available - minAmountUsd - maxAmountUsd - reason - suggestedAction - clearsAt - clearsAtIsEstimate 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 maxAmountUsd: description: >- The largest principal amount accepted for a high-priority request. It is calculated so the principal plus the blended fee stays within the total bank-debit limit. type: string example: '0.00' maxEarlyReleaseAmountUsd: description: >- The largest principal amount that may be released before ACH settlement. This is the early portion, not the maximum total deposit; use maxAmountUsd to validate the full high-priority deposit. type: string example: '0.00' reason: description: >- Why high priority is unavailable; null when available anyOf: - type: string nullable: true enum: - not_available - type: string enum: - minimum_deposit - transaction_limit - daily_limit - monthly_limit - unsettled_deposit_limit - unsettled_amount_limit - bank_unsettled_deposit_limit - open_exposure - aggregate_exposure - new_user_admission_paused - rail_halted description: >- Machine-readable reason a deposit would currently be blocked suggestedAction: type: string enum: - auto_ramp - wait_for_settlement - null description: >- Suggested next step when unavailable; null otherwise nullable: true clearsAt: format: date-time type: string description: >- Earliest instant the current `reason` can stop applying, or null when it is not time-bound. Derived from the same state that produced `reason`; another limit may bind after it, so re-fetch before submitting. nullable: true example: '2026-08-24T15:00:00.000Z' clearsAtIsEstimate: description: >- True when `clearsAt` is a forecast (expected ACH settlement, exposure ageing out) rather than a fixed boundary such as a daily window reset. type: boolean required: - available - maxAmountUsd - maxEarlyReleaseAmountUsd - reason - suggestedAction - clearsAt - clearsAtIsEstimate required: - normal - high required: - minimumDepositAmountUsd - transactionLimitUsd - limitsByPriority '401': description: Response for status 401 content: application/problem+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/problem+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/problem+json: schema: additionalProperties: true 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 retryAfter: description: >- Seconds to wait before retrying, present alongside `retryable: true`. Mirrors the `Retry-After` response header and is meant for short backoffs the server chose (load shedding); for a condition that clears on its own schedule, `clearsAt` carries the absolute time instead. type: number example: 5 suggestedAction: type: string enum: - auto_ramp - wait_for_settlement clearsAt: format: date-time type: string description: >- Earliest known time the current temporary condition may clear. nullable: true availableAt: format: date-time type: string description: >- When a temporarily ineligible funding source may become available again. nullable: true permanent: description: >- Whether the current funding-source restriction will not clear automatically. type: boolean required: - title - status security: - bearerAuth: [] - integratorJwt: [] - bearerAuth: [] hmacAuth: [] integratorKey: [] timestamp: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT or ak_ user API key description: >- User bearer credential: either a Cognito JWT or an ak_ user API key. Backend integrators using HMAC must include the user API key alongside the three HMAC headers on user-scoped endpoints. 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: ik_...) - 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: ik_...) used with HMAC authentication' timestamp: type: apiKey in: header name: X-Timestamp description: >- Unix timestamp in milliseconds for request freshness. Must be within 5 minutes of server time. The timestamp alone bounds but does not prevent an exact replay within that window. Use Idempotency-Key on supported mutations. ````