---
title: "Check if 3D Secure is available"
method: POST
path: "/get3dsAvailability"
tags: ["General"]
---

# Check if 3D Secure is available

`POST /get3dsAvailability`

Verifies whether 3D Secure is available for the specified BIN or card brand. For 3D Secure 2, this endpoint also returns device fingerprinting keys.

For more information, refer to [3D Secure 2](https://docs.adyen.com/online-payments/3d-secure/native-3ds2).

## Request body

- ThreeDSAvailabilityRequest
  - `additionalData` object — This field contains additional data, which may be required for a particular request. The `additionalData` object consists of entries, each of which includes the key and value.
  - `brands` string[] — List of brands.
  - `cardNumber` string — Card number or BIN.
  - `merchantAccount` string, required — The merchant account identifier.
  - `recurringDetailReference` string — A recurring detail reference corresponding to a card.
  - `shopperReference` string — The shopper's reference to uniquely identify this shopper (e.g. user ID or account ID).

## Response `200`

OK - the request has succeeded.

- ThreeDSAvailabilityResponse
  - `dsPublicKeys` DSPublicKeyDetail[] — List of Directory Server (DS) public keys.
    - `brand` string — Card brand.
    - `directoryServerId` string — Directory Server (DS) identifier.
    - `fromSDKVersion` string — The version of the mobile 3D Secure 2 SDK. For the possible values, refer to the versions in [Adyen 3DS2 Android](https://github.com/Adyen/adyen-3ds2-android/releases) and [Adyen 3DS2 iOS](https://github.com/Adyen/adyen-3ds2-ios/releases).
    - `publicKey` string, byte — Public key. The 3D Secure 2 SDK encrypts the device information by using the DS public key.
    - `rootCertificates` string — Directory Server root certificates. The 3D Secure 2 SDK verifies the ACS signed content using the rootCertificates.
  - `threeDS1Supported` boolean — Indicator if 3D Secure 1 is supported.
  - `threeDS2CardRangeDetails` ThreeDS2CardRangeDetail[] — List of brand and card range pairs.
    - `brandCode` string — Card brand.
    - `endRange` string — BIN end range.
    - `startRange` string — BIN start range.
    - `threeDS2Version` string — 3D Secure protocol version.
    - `threeDSMethodURL` string — In a 3D Secure 2 browser-based flow, this is the URL where you should send the device fingerprint to.
  - `threeDS2supported` boolean — Indicator if 3D Secure 2 is supported.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/binlookupservice.md) · [All operations](https://skmtc.net/adyen/apis/binlookupservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/binlookupservice/versions/0e29a2e42c98/schema)