Skip to main content
POST
/
organizations
/
{organization_id}
/
verification
조직 인증 신청
curl --request POST \
  --url https://client-api.tryvox.co/v3/organizations/{organization_id}/verification \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form identity_document='@example-file' \
  --form applicant_user_id=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --form 'business_registration=<string>' \
  --form business_registration.0='@example-file'
{
  "id": "<string>",
  "status": "<string>",
  "created_at": 123
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
organization_id
string
required

인증을 신청할 조직 ID입니다(본인 또는 직속 하위 조직).

Body

multipart/form-data

이 엔드포인트가 받는 multipart 폼 데이터입니다.

​
verification_type
enum<string>
required

인증 유형: personal, sole_proprietor, 또는 corporation.

Available options:
personal,
sole_proprietor,
corporation
​
identity_document
file
required

신분증 이미지(주민등록증 또는 운전면허증). JPEG, PNG, WebP, 또는 PDF, 10 MB 이하.

​
verification_case
enum<string> | null

사업자 전용 항목입니다. self(신청자가 대표자) 또는 employee를 보내며, 개인(personal)에는 지정하지 않습니다.

Available options:
self,
employee
​
applicant_user_id
string<uuid> | null

신청자로 지정할 멤버의 사용자 ID(uuid)입니다. 생략하면 조직 오너로 설정됩니다. 신청자는 본인 인증을 마친 조직 멤버여야 합니다.

​
business_registration
file | null

사업자등록증입니다. 개인사업자·법인(sole_proprietor/corporation)은 필수이며, JPEG·PNG·WebP·PDF 형식에 10 MB 이하여야 합니다.

Response

성공 응답

인증 신청 접수 응답입니다. 생성된 인증 기록의 식별 정보를 제공합니다.

​
id
string
required

생성된 인증 기록 ID입니다. 상태 조회의 latest.id와 같으며, 처리 결과는 상태 조회로 확인합니다.

​
status
string
required

접수 직후 상태입니다. 항상 requested이며, 이후 상태는 상태 조회로 확인합니다.

​
created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.