Skip to main content

License Submission

After creating a property, submit its permit and business registration certificate to ONDA for review. For the full sequence, see the Initial Setup overview.

:::warning Prerequisite for opening Plus channels Before you request to open a Plus channel, check that both the permit (permit) and the business registration certificate (business) have status confirm. :::

:::info One active document per type ONDA uses one approved permit (permit) and one approved business registration certificate (business) per property. To replace a document, submit a new one of the same type. ONDA continues to use the previous document until it approves the replacement (confirm). :::

MethodPathDescription
POST.../{vendor_property_id}/licensesSubmit a document (one request per document)
GET.../{vendor_property_id}/licensesList submissions (newest first)
GET.../{vendor_property_id}/licenses/{request_id}Get a submission (including status history)

The list endpoint starts with the most recent requests. It skips offset requests (default 0) and returns up to limit requests (default 100, maximum 500). count is the total number of requests for the property.

Document types​

Set the document type with type, and put the document fields and file in data.

typeDocumentRequired data fields
permitLicense document (business report certificate, tourism business registration, rural homestay registration, etc.)type (license type code), number (report/registration number), date (report/registration date), issuer (issuing authority), file
businessBusiness registration certificatetype (corporation / personal), number (10-digit business registration number), owner_name (representative), open_date (business opening date), file
  • For a permit, set issuer to the authority named on the document (up to 100 characters). If you send the optional status field, use a code from the table below.
  • For a corporation (corporation), name (business name), address (business address), industry (industry), and category (business category) are also required. They are optional for a sole proprietor.
  • Maximum lengths: permit number 254, issuer 100 / business owner_name 128, name and address 254, industry and category 64 / comment (both) 16,000 characters
  • Dates use YYYY-MM-DD; future dates are rejected (Korea time).
  • The business registration number is accepted with or without hyphens.
  • Use comment (optional) for notes to the reviewer.

License type codes (data.type for permit)​

CodeLicense type
general_lodgingGeneral lodging business
residential_lodgingResidential lodging business
foreign_tourist_urban_homestayUrban homestay for foreign tourists
hanok_experienceHanok experience
rural_homestayRural homestay
tourist_hotelTourist hotel
floating_tourist_hotelFloating tourist hotel
korean_traditional_hotelKorean traditional hotel
family_hotelFamily hotel
hostelHostel
small_hotelSmall hotel
medical_tourism_hotelMedical tourism hotel
youth_hostelYouth hostel
resort_condominiumResort condominium
tourist_pensionTourist pension
resort_pensionResort pension business
general_campgroundGeneral campground business
auto_campgroundAuto campground business
forest_lodgeForest lodge / forest recreation lodge
gosiwonGosiwon
shared_homestayShared homestay business
specialized_resortSpecialized resort business

License status codes (data.status for permit, optional)​

Use the Korean local government code for the operating status at the time of submission. If you omit status, the submission details return null.

CodeStatus
01Active
02Suspended
03Closed
04Canceled / revoked / expired / halted
05Excluded / deleted / transferred
06Other

File rules​

ItemRule
TransferBase64-encoded string in data.file (file names are not accepted)
Supported formatsjpeg, png, gif, webp, pdf (detected from the file content)
Unsupported formatsHEIC, AVIF, etc.
Image sizeAt least 450px wide and 200px tall
File sizeUp to 10MB per file (base64 encoding makes the request body about 1.33 times larger)

Request examples​

License document (permit)

{
"type": "permit",
"data": {
"type": "general_lodging",
"number": "No. 2026-00123",
"date": "2026-03-02",
"issuer": "Mayor of Gangnam-gu, Seoul",
"status": "01",
"file": "JVBERi0xLjQKJeLjz9MK..."
},
"comment": "Document reissued in March 2026."
}

Business registration (business) — corporation

{
"type": "business",
"data": {
"type": "corporation",
"number": "123-45-67891",
"owner_name": "Hong Gil-dong",
"open_date": "2020-05-01",
"name": "Example Hotel Co., Ltd.",
"address": "1 Teheran-ro, Gangnam-gu, Seoul",
"industry": "Lodging",
"category": "Hotel",
"file": "JVBERi0xLjQKJeLjz9MK..."
}
}

For a sole proprietor (personal), name, address, industry, and category can be omitted.

The examples show only part of the file value. Encode the entire file as base64 and send the full string. The API returns 400 if you send a truncated value.

Error responses​

CodeWhen
400A required field is missing or malformed: an unsupported type, a data.type not in the code list, a missing data.issuer for permit, a data.status not in the code list, a business registration number with an invalid length or checksum, a future date, a file that cannot be read as base64, or a corporation missing name, address, industry, or category. Also returned for an out-of-range offset or limit in the list, and a request_id that is not a positive integer in the detail lookup
404vendor_property_id is not a property of this vendor. In the detail lookup, also when request_id is not a request for that property
413The request body is too large
422Unsupported file format (unsupported formats such as HEIC and AVIF), Image must be at least 450x200 pixels (image too small), Image conversion failed (the image could not be converted to JPG)

Review status​

  • If you submit another document of the same type while one is pending, the API marks the earlier request as reject and records Superseded by request {new request ID} in reason. If the new request fails with 400 or 422, the earlier request stays pending.
  • Check reason in the list or submission details for the reason ONDA rejected the document. Correct the issue and submit the document again.
  • The submission details return histories in reverse chronological order. has_file reports whether ONDA stored the file. The API omits the file itself and masks the last five digits of the business registration number.
  • Omitted optional fields, including comment, return null. The API also returns null in reason when there is no status change reason, or in data.type when the license type is missing from the code list.