Skip to main content
GET
/
service-providers
/
limits
/
kyc-fiat-levels
Get KYC levels for fiat currencies
curl --request GET \
  --url https://api-sb.meld.io/service-providers/limits/kyc-fiat-levels \
  --header 'Authorization: <api-key>'
[
  {
    "accountDetails": {},
    "currencyCode": "<string>",
    "level1": {
      "daily": 123,
      "monthly": 123,
      "transaction": 123,
      "weekly": 123,
      "yearly": 123
    },
    "level2": {
      "daily": 123,
      "monthly": 123,
      "transaction": 123,
      "weekly": 123,
      "yearly": 123
    },
    "level3": {
      "daily": 123,
      "monthly": 123,
      "transaction": 123,
      "weekly": 123,
      "yearly": 123
    },
    "serviceProviderDetails": {}
  }
]

Authorizations

​
Authorization
string
header
default:BASIC <Meld API Key>
required

Query Parameters

​
serviceProviders
string

A comma separated list of service providers.

​
statuses
string
default:LIVE,RECENTLY_ADDED

A comma separated list of service provider statuses. Valid values are: LIVE,RECENTLY_ADDED,BUILDING

​
categories
string

A comma separated list of service provider categories. Valid values are: BANK_LINKING,CRYPTO_OFFRAMP,CRYPTO_ONRAMP,CRYPTO_TRANSFER,CRYPTO_VIRTUAL_ACCOUNT_OFFRAMP,CRYPTO_VIRTUAL_ACCOUNT_ONRAMP,FIAT_PAYMENTS. Note: CRYPTO_ONRAMP_SWAP and CRYPTO_OFFRAMP_SWAP are server-driven and cannot be requested directly.

​
accountFilter
boolean
default:false

Filter by account configuration. Will only include properties supported by the service providers configured for the account of the API authentication token used.

​
countries
string

A comma separated list of countries.

​
fiatCurrencies
string

A comma separated list of fiat currencies.

​
cryptoChains
string

A comma separated list of crypto chains.

​
cryptoCurrencies
string

A comma separated list of crypto currencies.

​
paymentMethodTypes
string

A comma separated list of payment method types. Valid Values are: Supported Payment Methods

​
includeDetails
boolean
default:false

When true, includes details about any account, Meld, and/or service provider limits used for each limit in the response.

Response

Limits returned

​
accountDetails
object

The account service provider limit overrides. Only present when includeDetails request parameter is set to true.

​
currencyCode
string

The currency code for these KYC Fiat Level limits.

​
level1
object

KYC Level 1 limits, level 1 means no document upload is required. Typical information asked for in level 1 include phone number, email address, and SSN (or international equivalent)

​
level2
object

KYC Level 2 limits, level 2 means document upload is required. Typical information asked for in level 2 include passport and drivers license (or international equivalent).

​
level3
object

KYC Level 3 limits, level 3 means proof of funds is required. This is for very large purposes, and may involve connecting a user's bank account to show proof of funds.

​
serviceProviderDetails
object

The service provider limits. Only present when includeDetails request parameter is set to true.