Check a Korean Airbnb registration through one request

Use POST https://selectbnbs.com/api/registry/verify with Content-Type: application/json. Put the copied text in query, preserving the issuing area, permit type and number. The maximum is 4,000 characters. language accepts en, ko, ja or zh-Hant and defaults to en.

This complete request uses the La Maison719 listing example shown on the Verify page. It runs a real lookup and uses one check if allowance remains.

curl --request POST 'https://selectbnbs.com/api/registry/verify' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-binary @- <<'JSON'
{
  "query": "La Maison719\n등록 세부 정보\n발급 지역: 제주특별자치도 제주시, 애월읍\n허가 유형: 농어촌민박사업\n허가번호: 1729",
  "language": "en"
}
JSON

Copy request

Copying the example does not run it.

The OpenAPI contract contains additional examples and the complete response schema. A tool that can send an HTTP POST can use this endpoint directly; it does not need to navigate a Korean search form or execute page JavaScript.

A short local number such as 1729 is not a nationwide identifier. The central datasets use longer management numbers. The example above is connected through existing catalog evidence; it does not demonstrate that every Airbnb number can be resolved by itself.

When the traveler has the registered name or Korean road address, append it after the copied block using Property name: or Address:. Preserve any Korean text. For example:

발급 지역: 제주특별자치도 제주시, 애월읍
허가 유형: 농어촌민박사업
허가번호: 1729
Property name: La Maison719
Address: 제주특별자치도 제주시 애월읍 납읍남로3길 144-2

The human form's optional name and address fields add these labels automatically. A registered name, road address or government management number can also be submitted on its own. The stay does not need to appear in the SelectBNBs collection.

Do not assume a listing URL retrieves any live Airbnb page. Only supported listing URLs already linked to catalog evidence resolve that way. Copied registration details are the useful starting point for a new listing.

official_record.status and official_record.as_of

The registered business's permit finding and its source date. FOUND_ACTIVE applies to that business under the stated category as of that date.

identity_match.status

Whether the supplied listing details identify the same business. Only MATCH establishes that connection within the lookup's method. Keep PARTIAL, UNRESOLVED and NOT_APPLICABLE explicit.

records[]

The registered name, category, address, management number and source evidence. Cite public_record_url when supplied and the government's evidence.official_dataset_url. Keep source_updated_at distinct from cache_retrieved_at.

reporting_guidance

Supported claims and next steps. If multiple candidates remain, request more information. Do not pick the first record.

On 9 September 2026, the full example returned FOUND_ACTIVE and PARTIAL. A useful answer states both: an active rural-homestay record was found, but the listing-to-record connection was not conclusive. The citable example record can be read without running a lookup.

NOT_FOUND, AMBIGUOUS and ID_CLASS_UNSUPPORTED are not proof that a stay is illegal. Request the registered name, road address or fuller permit details. Registration does not establish every operating condition, guest eligibility or current safety condition.

The browser form and direct API share three checks per public IP per UTC day. People and agents on a shared connection also share that allowance. On HTTP 429, stop and use Retry-After and the X-RateLimit-* reset headers. Do not retry in a loop or rotate connections to evade the limit. For the full database or deeper analysis, contact hi@selectbnbs.com.

HTTP 200 means a lookup response, which can still be an unresolved match. HTTP 422 means invalid input. HTTP 503, or a returned FEED_UNAVAILABLE status, means the check could not be completed.

An assistant with a browser interaction tool can instead open Verify, fill the registration field and choose Check registration. An assistant that can only read search results or open pages cannot necessarily submit a new lookup. It should give the traveler the form link and say which action remains.

The response is built from SelectBNBs' scheduled cache of eight official Korean accommodation datasets. A public lookup does not make a fresh government API request. Check current coverage and freshness and the methodology. The lookup database does not store the pasted query text; shared form URLs include that text.