GET

Wyndham URL to Hotel ID API

Resolve a public Wyndham hotel URL to its numeric property ID.

Copy for your AI agent

Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.

Overview

Resolve a URL to a property ID

StayAPI reads the hotel slug from the URL and resolves it to Wyndham's numeric property ID.

Use this endpoint when you have a canonical wyndhamhotels.com URL but need the numeric property_id accepted by Wyndham Rooms. Wyndham Search also returns the same identifier.

Endpoint URL

GET https://api.stayapi.com/v1/wyndham/hotel/url-to-id

Authenticate with X-API-Key: YOUR_API_KEY.

Query parameter

Parameter	Type	Required	Rules
url	URL string	Yes	HTTP or HTTPS URL on `wyndhamhotels.com` or a subdomain. It must contain a hotel-specific slug, for example `/laquinta/forsyth-georgia/la-quinta-forsyth/overview`.

Response schema

url: normalized input URL with a lowercase host and no query string or fragment.
property_id: numeric Wyndham identifier used by Rooms.
name and brand_code: nullable property metadata.

Errors and limitations

Errors follow RFC 7807 Problem Details with provider: "wyndham", product: "url-to-id", the supplied provided_url, and a correlation_id.

400 INVALID_URL: invalid scheme or non-Wyndham host.
400 PROPERTY_SLUG_NOT_FOUND: valid Wyndham host without a hotel slug.
404 PROPERTY_NOT_FOUND: Wyndham has no property matching the slug.
502 UPSTREAM_ERROR: Wyndham could not complete the lookup or returned an ambiguous result.

This resolver accepts canonical Wyndham hotel URLs, not city pages or free-form hotel names. It is not paginated or cached.

Request

curl -G "https://api.stayapi.com/v1/wyndham/hotel/url-to-id" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "url=https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"

const params = new URLSearchParams({
  url: "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"
});
const response = await fetch(`https://api.stayapi.com/v1/wyndham/hotel/url-to-id?${params}`, {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/wyndham/hotel/url-to-id",
    params={"url": "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.stayapi.com/v1/wyndham/hotel/url-to-id")
uri.query = URI.encode_www_form(url: "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = "YOUR_API_KEY"
puts Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }.body

Response

{
  "success": true,
  "url": "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview",
  "property_id": "53089",
  "name": "La Quinta Inn & Suites by Wyndham Forsyth",
  "brand_code": "LQ"
}

{
  "type": "https://api.stayapi.com/errors/property-not-found",
  "title": "Property Not Found",
  "status": 404,
  "detail": "No Wyndham property matched the hotel URL",
  "instance": "/v1/wyndham/hotel/url-to-id",
  "provider": "wyndham",
  "product": "url-to-id",
  "error_code": "PROPERTY_NOT_FOUND",
  "provided_url": "https://www.wyndhamhotels.com/laquinta/example/example/overview",
  "correlation_id": "req_abc123"
}