Skip to main content
GET
/
organizations
/
{organization_id}
/
verification
조직 인증 상태 조회
curl --request GET \
  --url https://client-api.tryvox.co/v3/organizations/{organization_id}/verification \
  --header 'Authorization: Bearer <token>'
{
  "currently_verified": true,
  "latest": {
    "id": "<string>",
    "status": "<string>",
    "verification_type": "<string>",
    "verification_case": "<string>",
    "grade": "<string>",
    "company_name": "<string>",
    "business_registration_number": "<string>",
    "rejection_reason": "<string>",
    "failure_code": "<string>",
    "submitted_at": 123,
    "approved_at": 123,
    "rejected_at": 123
  },
  "current_grade": "<string>"
}

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

organization_id
string
required

인증 상태를 조회할 조직 ID입니다(본인 또는 직속 하위 조직).

Response

성공 응답

인증 상태 조회 응답입니다. 가장 최근 인증 기록과 현재 유효한 인증 요약을 함께 제공합니다.

currently_verified
boolean
required

현재 유효한 승인이 있는지 여부입니다. 재인증이 진행 중이어도 이전 승인은 유지됩니다.

latest
LatestVerificationView · object

가장 최근 인증 기록입니다. 신청 이력이 없으면 null입니다.

current_grade
string | null

현재 유효한 인증 등급입니다(personal/sole_proprietor/corporation). 미인증이면 null입니다.