Skip to main content

Submit License

POST 

/gds/vendor/properties/:vendor_property_id/licenses

  • Submits a property's permit (permit) or business registration certificate (business). Send one document per request and set type to the document type.
  • Use permit for documents such as a business report certificate, tourism business registration, or rural homestay registration. Set data.type to the license type code.
  • For permit, data.issuer is required and data.status is optional. Enter the issuing authority in data.issuer exactly as it appears on the document.
  • Put the document fields and file in data. Send the file as a base64 string without a file name.
  • The API detects the format from the file contents. It supports JPEG, PNG, GIF, WebP, and PDF. It does not support HEIC or AVIF. Images must be at least 450 pixels wide and 200 pixels tall. Each file can be up to 10 MB.
  • For business, if data.type is corporation, data.name, data.address, data.industry, and data.category are also required. They are optional for a sole proprietor (personal).
  • ONDA sets new submissions to pending. After review, ONDA sets the status to confirm (approved) or reject (rejected).
  • 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.
  • Opening a Plus channel requires both permit and business to have status confirm. ONDA uses the most recently approved document of each type until it approves a replacement.

Request​

Responsesapplication/json​

Returns the accepted submission request.