---
title: "Retrieve multi currency account eligibility"
method: GET
path: "/v4/multi-currency-account/eligibility"
tags: ["multi-currency-account"]
---

# Retrieve multi currency account eligibility

`GET /v4/multi-currency-account/eligibility`

Checks eligibility for a multi-currency account for either a specific profile or for a location. Customers in some countries and states/provinces may not be eligible for a multi currency account.

To check a profile, pass the `profileId` as a query parameter.

To check a specific location, pass the `country` using 2-letter ISO 3166 codes. If the country is `US`, a valid 2-letter `state` parameter must also be passed.

- Example (France): `/v4/multi-currency-account/eligibility?country=FR`
- Example (USA, California): `/v4/multi-currency-account/eligibility?country=US&state=CA`

## Query parameters

- `profileId` integer
- `country` string
- `state` string

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

Eligibility result.

- object
  - `eligible` boolean — Whether the profile is eligible for a multi currency account.
  - `eligibilityCode` 'eligible' | 'invalid.profile.type' | 'invalid.country' | 'invalid.state' — Eligibility status code.
  - `accountType` 'FULL' | 'RECEIVE_ONLY' | 'INELIGIBLE' — Account type available.
  - `ineligibilityReason` string, nullable — Reason the profile is not eligible.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)
