# Get identity verification result API

### Gets identity verification result.

## Gets identity verification result by imp\_uid.

<mark style="color:blue;">`GET`</mark> `https://api.iamport.kr/certifications/{imp_uid}`

#### Request Body

| Name                                       | Type   | Description                                                 |
| ------------------------------------------ | ------ | ----------------------------------------------------------- |
| imp\_uid<mark style="color:red;">\*</mark> | String | <mark style="color:red;">**i'mport verification ID**</mark> |

{% tabs %}
{% 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="200: OK Success" %}
{% tabs %}
{% tab title="CertificationResponse" %}
**`code`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:purple;">**integer**</mark>

**Response code**

0: success, Not 0: check the message

**`message`** <mark style="color:red;">**\***</mark>**&#x20;**<mark style="color:green;">**string**</mark>

**Response message**

A non-zero code includes a message like 'Invalid payment info'.

**response** <mark style="color:red;">**(CertificationAnnotation, optional)**</mark>
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="CertificationAnnotation" %}
**`imp_uid`**  <mark style="color:red;">\*</mark> <mark style="color:green;">**string**</mark>&#x20;

**`verification ID`**

**`merchant_uid`**  <mark style="color:green;">**string**</mark>

**`Order ID`**

**`pg_tid`**  <mark style="color:green;">**string**</mark>

**`PG verification ID`**&#x20;

**`pg_provider`** <mark style="color:red;">**\***</mark>**&#x20;&#x20;**<mark style="color:green;">**string**</mark>&#x20;

**`PG provider`**

**`name`**   <mark style="color:green;">**string**</mark>&#x20;

**`Name`**&#x20;

&#x20;

**`gender`**  <mark style="color:green;">**string**</mark>

**`Gender`**&#x20;

* male
* female

**`birthday`  &#x20;**<mark style="color:green;">**string**</mark>

**`DOB`**&#x20;

ISO8601 date in string format. <mark style="color:red;">YYYY-MM-DD (10-digit)</mark>

**`foreigner`**  <mark style="color:red;">**\***</mark>  <mark style="color:orange;">**boolean**</mark>

**`Foreigner status`**

<mark style="color:red;">When signing a Danal identity verification service contract</mark>, you must request to use foreigner identification service.

* true : foreigner
* false : not foreigner

&#x20;**`phone`**  <mark style="color:green;">**string**</mark>

**`Mobile phone number`**&#x20;

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 **<cs@iamport.kr>**.

**`carrier`**  <mark style="color:green;">**string**</mark>

**`Mobile carrier`**&#x20;

Requires pre-approval from the carrier (send a request with your Danal CPID to **<cs@iamport.kr>**).&#x20;

* SKT
* KT
* LGT
* SKT\_MVNO
* KT\_MVNO
* LGT\_MVNO

**`certified`**   <mark style="color:red;">**\***</mark>  <mark style="color:orange;">**boolean**</mark>

**`Whether verification is successful`**

&#x20;

**`certified_at`**    <mark style="color:green;">**string**</mark>

**`Verified at`** (UNIX timestamp)&#x20;

**`unique_key` &#x20;**<mark style="color:green;">**string**</mark>

**`Personal Identification Key (CI)`**

**`unique_in_site`**   <mark style="color:green;">**string**</mark>

**`Merchant Personal Identification Key (DI)`**

**`origin`**  <mark style="color:green;">**string**</mark>

**URL of the web page where the identity verification process is processed**

**`foreigner_v2`**   <mark style="color:orange;">**boolean**</mark>

**`Foreigner status (nullable)`**

* true : foreigner
* false : not foreigner

Requires a separate request to use Danal identity verification service
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

<details>

<summary>Response Model Schema</summary>

```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
  }
}
```

</details>

{% hint style="success" %}
**Swagger Test Link**

[**https://api.iamport.kr/#!/certifications/getCertification**](https://api.iamport.kr/#!/certifications/getCertification)
{% endhint %}
