# VASP 목록 조회

## CODE 와 연동되어 동작 중인 모든 VASP 의 목록을 반환합니다.

<mark style="color:blue;">`GET`</mark> `GET /v1/code/vasps`

VASP 는 이 API 를 호출하여 서비스 가능한 VASP 목록 및 VASP 정보를 얻을 수 있습니다.

주기적으로 호출하여 정보를 갱신할 것을 권장합니다.

**Response Body**

*200 OK*

*RESPONSE SCHEMA: application/json*

* health(Required): VASP API 서버의 liveness 확인 결과입니다. 값이 up 이면 서비스 가능한 상태이고, down 이면 서비스 불가능한 상태입니다. down 의 경우 요청을 보내지 않아야 합니다.
* vaspEntityId(Required): CODE 시스템 내에서 VASP 에 부여하는 Unique ID 로 다른 VASP 와 중복되지 않습니다.
* vaspName(Required): VASP 표기 이름입니다. VASP 의 영문 법인명과 같으며 VASP 목록에서 특정 VASP 를 찾기 위한 Key 로 사용합니다. (ex. Coinone, Bithumb, Korbit 등)
* countryOfRegistration(Required): VASP 가 등록된 국가의 코드로 ISO-3166-1 alpha-2 에서 정하는 2글자 국가 코드입니다. 예) KR, JP, US 등
* allianceName(Required): 해당 VASP 가 회원으로 참여하고 있는 Travel Rule Solution 이름입니다. (ex. code, verifyvasp 등)
* pubkeys(Required): VASP 앞으로 등록된 pubkey 객체의 배열입니다. 현재는 배열의 요소는 한 개이며, 각 객체는 pubkey 와 expiresAt 필드로 구성됩니다.
  * pubkey: base64 인코딩된 Public Key 입니다.
  * expiresAt: pubkey 의 만료 시각의 ISO8601 UTC 표기입니다.

```
{
  "vasps": [
    {
      "health": "up",
      "vaspEntityId": "coinone",
      "vaspName": "Coinone Exchange",
      "countryOfRegistration": "KR",
      "allianceName": "code",
      "pubkeys": [
        {
          "pubkey": "base64 encoded ascii",
          "expiresAt": "2030-06-31T23:59:59Z"
        }
      ]
    }
  ]
}
```