# Confirm identity verification API
### Confirms the identity verification based on the submitted verification ID and OTP number.
## Confirms the identity verification based on the submitted verification ID and OTP number.
`POST` `https://api.iamport.kr/certifications/otp/confirm/{imp_uid}`
If verification is successful, this return a response with the user's name, phone number, carrier, gender, foreigner status, date of birth, CI, and DI values.
#### Path Parameters
| Name | Type | Description |
| ------------------------------------------ | ------ | ----------------------------------------------------------- |
| imp\_uid\* | String | **i'mport verification ID** |
#### Request Body
| Name | Type | Description |
| ------------------------------------- | ------ | --------------------------------------------------------------- |
| otp\* | String | **OTP number received via SMS** |
{% tabs %}
{% tab title="200: OK Success" %}
{% tabs %}
{% tab title="CertificationResponse" %}
**`code`** **\***** ****integer**
**Response code**
0: success, Not 0: check the message
**`message`** **\***** ****string**
**Response message**
A non-zero code includes a message like 'Invalid payment info'.
**response** **(CertificationAnnotation, optional)**
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="CertificationAnnotation" %}
**`imp_uid`** \* **string**
**`verification ID`**
**`merchant_uid`** **string**
**`Order ID`**
**`pg_tid`** **string**
**`PG verification ID`**
**`pg_provider`** **\***** ****string**
**`PG provider`**
**`name`** **string**
**`Name`**
**`gender`** **string**
**`Gender`**
* male
* female
**`birthday` ****string**
**`DOB`**
ISO8601 date in string format. YYYY-MM-DD (10-digit)
**`foreigner`** **\*** **boolean**
**`Foreigner status`**
When signing a Danal identity verification service contract, you must request to use foreigner identification service.
* true : foreigner
* false : not foreigner
**`phone`** **string**
**`Mobile phone number`**
Returns mobile phone number with only numbers without special symbols. This attribute is omitted unless pre-approved by the carrier. For pre-approval from the carrier, send a request with your Danal CPID to ****.
**`carrier`** **string**
**`Mobile carrier`**
Requires pre-approval from the carrier (send a request with your Danal CPID to ****).
* SKT
* KT
* LGT
* SKT\_MVNO
* KT\_MVNO
* LGT\_MVNO
**`certified`** **\*** **boolean**
**`Whether verification is successful`**
**`certified_at`** **string**
**`Verified at`** (UNIX timestamp)
**`unique_key` ****string**
**`Personal Identification Key (CI)`**
**`unique_in_site`** **string**
**`Merchant Personal Identification Key (DI)`**
**`origin`** **string**
**URL of the web page where the identity verification process is processed**
**`foreigner_v2`** **boolean**
**`Foreigner status (nullable)`**
* true : foreigner
* false : not foreigner
Requires a separate request to use Danal identity verification service
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request Missing or invalid parameter error" %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="401: Unauthorized Missing or invalid access token" %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="404: Not Found Result not found" %}
```javascript
{
// Response
}
```
{% endtab %}
{% tab title="500: Internal Server Error Danal server error" %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
Response Model Schema
```json
{
"code": 0,
"message": "string",
"response": {
"imp_uid": "string",
"merchant_uid": "string",
"pg_tid": "string",
"pg_provider": "string",
"name": "string",
"gender": "string",
"birth": 0,
"birthday": "string",
"foreigner": true,
"phone": "string",
"carrier": "SKT",
"certified": true,
"certified_at": 0,
"unique_key": "string",
"unique_in_site": "string",
"origin": "string",
"foreigner_v2": true
}
}
```
{% hint style="success" %}
**Swagger Test Link**
[**https://api.iamport.kr/#!/certifications/confirmOTP**](https://api.iamport.kr/#!/certifications/confirmOTP)
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://portone.gitbook.io/docs-en/api/identity-verification-api/confirm-identity-verification-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.