# Get3dSecureThreeDSecure

From **Stripe API**.

`GET /v1/3d_secure/{three_d_secure}`

<p>Retrieves a 3D Secure object.</p>

## Parameters

### `expand`

- Location: query
- Required: false
- Type: `array`

Specifies which fields in the response should be expanded.

### `three_d_secure`

- Location: path
- Required: true
- Type: `string`
- maxLength: `5000`

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

## Security

### `basicAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.

Basic HTTP authentication. Allowed headers-- Authorization: Basic <api_key> | Authorization: Basic <base64 hash of `api_key:`>

### `bearerAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

## Responses

### `200`

Successful response.

### `application/json`

- Type: `object`

Cardholder authentication via 3D Secure is initiated by creating a `3D Secure`
object. Once the object has been created, you can use it to authenticate the
cardholder and create a charge.

```json
{"description":"Cardholder authentication via 3D Secure is initiated by creating a `3D Secure`\nobject. Once the object has been created, you can use it to authenticate the\ncardholder and create a charge.","properties":{"amount":{"description":"Amount of the charge that you will create when authentication completes.","type":"integer"},"authenticated":{"description":"True if the cardholder went through the authentication flow and their bank indicated that authentication succeeded.","type":"boolean"},"card":{"$ref":"#/components/schemas/card"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","maxLength":5000,"type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["three_d_secure"],"type":"string"},"redirect_url":{"description":"If present, this is the URL that you should send the cardholder to for authentication. If you are going to use Stripe.js to display the authentication page in an iframe, you should use the value \"_callback\".","maxLength":5000,"nullable":true,"type":"string"},"status":{"description":"Possible values are `redirect_pending`, `succeeded`, or `failed`. When the cardholder can be authenticated, the object starts with status `redirect_pending`. When liability will be shifted to the cardholder's bank (either because the cardholder was successfully authenticated, or because the bank has not implemented 3D Secure, the object wlil be in status `succeeded`. `failed` indicates that authentication was attempted unsuccessfully.","maxLength":5000,"type":"string"}},"required":["amount","authenticated","card","created","currency","id","livemode","object","status"],"title":"ThreeDSecure","type":"object","x-expandableFields":["card"],"x-resourceId":"three_d_secure"}
```

### `default`

Error response.

### `application/json`

- Type: `object`

An error response from the Stripe API

```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url https://api.stripe.com/v1/3d_secure/{three_d_secure} \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{}'
```