---
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.

## Changes

- **2023-10-11** (v40) `4f2d4d515f1c` — 1 info
  - added the optional property `dsPublicKeys/items/rootCertificates` to the response with the `200` status
- **2023-03-13** (v40) `a0ec4d9cb66e` — 9 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - …5 more
- **2021-08-07** (v40) `a3716a0ca285` — 4 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
  - api tag `General` added
  - added the optional property `dsPublicKeys/items/fromSDKVersion` to the response with the `200` status
- **2021-04-10** (v40) `bdb12d569792` — 5 info
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `403` status
  - added the optional property `status` to the response with the `422` status
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/adyen/apis/binlookupservice/changes/get3dsAvailability/post.md)

---

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