---
title: "Get instant withdrawal eligibility"
method: GET
path: "/v0/withdrawal-orders/instant-eligibility"
tags: ["Withdrawal orders"]
---

# Get instant withdrawal eligibility

`GET /v0/withdrawal-orders/instant-eligibility`

## Request

- Base URL: `https://distributor-api.spiko.io`
- URL: `https://distributor-api.spiko.io/v0/withdrawal-orders/instant-eligibility`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/spiko/apis/spiko-distributor-api/docs/v0/withdrawal-orders/instant-eligibility/get.ts> (a function with typed inputs; its response is checked against the schema)

**Check whether an investor can place an instant withdrawal, and how much.**

- Returns `{"eligible":false}` when instant withdrawals are unavailable for this investor and share class.
- When eligible, `availableAmount` is the remaining amount (in `EUR`) the investor can instantly withdraw today, and `bankSupportsInstant` indicates whether the destination bank accepts instant transfers (always `true` when `bankAccountId` is omitted).

## Query parameters

- `investorId` string, uuid, required: a Universally Unique Identifier
- `shareClassSymbol` 'EUTBL' | 'USTBL' | 'eurUSTBL' | 'SPKCC' | 'eurSPKCC' | 'UKTBL' | 'eurUKTBL' | 'SAFO' | 'SAFOd' | 'eurSAFO' | 'eurSAFOd' | 'gbpSAFO' | 'gbpSAFOd' | 'chfSAFO' | 'sekSAFO' | 'nokSAFO' | 'dkkSAFO' | 'plnSAFO' | 'hufSAFO' | 'czkSAFO', required
- `bankAccountId` string, uuid: a Universally Unique Identifier

## Response `200`

Success

- union
  - object
    - `eligible` false, required
  - object
    - `eligible` true, required
    - `bankSupportsInstant` boolean, required
    - `availableAmount` string, required

## Other responses

- `400`: The request did not match the expected schema
- `401`: Authentication failed. Two bodies are possible: the schema below when the API rejects the credentials, and `{ "error": { "code", "status", "request", "message" } }` when the API gateway rejects them first. Only the former carries a `_tag`.
- `403`: Forbidden
- `404`: Not Found
- `503`: The investor is undergoing a scheduled upgrade, access is temporarily paused to ensure data safety.

---

[API](https://skmtc.dev/spiko/apis/spiko-distributor-api.md) - [All operations](https://skmtc.dev/spiko/apis/spiko-distributor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spiko/apis/spiko-distributor-api/revisions/ad85137fd00b?raw)