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).
:::
| Method | Path | Description |
|---|---|---|
POST | .../{vendor_property_id}/licenses | Submit a document (one request per document) |
GET | .../{vendor_property_id}/licenses | List 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.
type | Document | Required data fields |
|---|---|---|
permit | License 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 |
business | Business registration certificate | type (corporation / personal), number (10-digit business registration number), owner_name (representative), open_date (business opening date), file |
- For a
permit, setissuerto the authority named on the document (up to 100 characters). If you send the optionalstatusfield, use a code from the table below. - For a corporation (
corporation),name(business name),address(business address),industry(industry), andcategory(business category) are also required. They are optional for a sole proprietor. - Maximum lengths:
permitnumber254,issuer100 /businessowner_name128,nameandaddress254,industryandcategory64 /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)
| Code | License type |
|---|---|
general_lodging | General lodging business |
residential_lodging | Residential lodging business |
foreign_tourist_urban_homestay | Urban homestay for foreign tourists |
hanok_experience | Hanok experience |
rural_homestay | Rural homestay |
tourist_hotel | Tourist hotel |
floating_tourist_hotel | Floating tourist hotel |
korean_traditional_hotel | Korean traditional hotel |
family_hotel | Family hotel |
hostel | Hostel |
small_hotel | Small hotel |
medical_tourism_hotel | Medical tourism hotel |
youth_hostel | Youth hostel |
resort_condominium | Resort condominium |
tourist_pension | Tourist pension |
resort_pension | Resort pension business |
general_campground | General campground business |
auto_campground | Auto campground business |
forest_lodge | Forest lodge / forest recreation lodge |
gosiwon | Gosiwon |
shared_homestay | Shared homestay business |
specialized_resort | Specialized 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.
| Code | Status |
|---|---|
01 | Active |
02 | Suspended |
03 | Closed |
04 | Canceled / revoked / expired / halted |
05 | Excluded / deleted / transferred |
06 | Other |
File rules
| Item | Rule |
|---|---|
| Transfer | Base64-encoded string in data.file (file names are not accepted) |
| Supported formats | jpeg, png, gif, webp, pdf (detected from the file content) |
| Unsupported formats | HEIC, AVIF, etc. |
| Image size | At least 450px wide and 200px tall |
| File size | Up 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
| Code | When |
|---|---|
400 | A 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 |
404 | vendor_property_id is not a property of this vendor. In the detail lookup, also when request_id is not a request for that property |
413 | The request body is too large |
422 | Unsupported 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 asrejectand recordsSuperseded by request {new request ID}inreason. If the new request fails with400or422, the earlier request stayspending. - Check
reasonin the list or submission details for the reason ONDA rejected the document. Correct the issue and submit the document again. - The submission details return
historiesin reverse chronological order.has_filereports 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, returnnull. The API also returnsnullinreasonwhen there is no status change reason, or indata.typewhen the license type is missing from the code list.