# Destination IDs for listing partners

**Release verification:** Verify the target API revision and canonical destination response before adopting this contract. This change applies to the date-free catalog, regional availability, direct listing content, and owner destination assignments. Listing/property/room IDs and booking links do not change.

Use a registered destination ID, not a bare town name. IDs are exact, lowercase identifiers. The suffix distinguishes places with the same name:

| Place | Destination ID | Parent search |
| --- | --- | --- |
| Julian, California, US | `julian-ca` | `east-county-san-diego-ca` |
| Aurora, Colorado, US | `aurora-co` | `colorado-us` |
| Aurora, Illinois, US | `aurora-il` | `illinois-us` |
| Paris, Texas, US | `paris-tx` | `texas-us` |
| Paris, France | `paris-fr` | `france-fr` |

US towns use a state suffix; international towns use a country suffix. These are registered IDs, not a rule clients should use to manufacture IDs. If a name/suffix combination would collide, the new place must receive additional geographic qualification before registration. Existing IDs never change meaning. Duplicate IDs and historical aliases fail catalog validation.

`aurora` and `paris` return HTTP 422 because neither identifies a registered place. Unknown IDs also return 422. A supported destination with no eligible inventory returns an empty result; registering a place does not create or publish properties.

## Requests

Set `WIKIUP_API_ORIGIN` to the preview or production API origin and keep `WIKIUP_API_KEY` on your server.

```sh
curl --silent --show-error --fail-with-body --get \
  "$WIKIUP_API_ORIGIN/api/travel/listings" \
  -H "Authorization: Bearer $WIKIUP_API_KEY" \
  -H 'Accept: application/json' \
  --data-urlencode 'destination=aurora-co' \
  --data-urlencode 'page=1' --data-urlencode 'pageSize=12'
```

```sh
curl --silent --show-error --fail-with-body --get \
  "$WIKIUP_API_ORIGIN/api/travel/availability" \
  -H "Authorization: Bearer $WIKIUP_API_KEY" \
  -H 'Accept: application/json' \
  --data-urlencode 'destination=paris-fr' \
  --data-urlencode 'checkIn=2027-01-10' \
  --data-urlencode 'checkOut=2027-01-12' \
  --data-urlencode 'adults=2' --data-urlencode 'children=0' --data-urlencode 'pets=0'
```

Catalog `query.destination`, catalog cards' `destination`, direct content's `listing.destination`, and regional results' `property.destination.id` use canonical IDs. For full populated responses, field definitions, pagination, and failures, see the [listing guide](travel-listings.md) and [response schema](travel-listings.schema.json). Batch availability continues to use listing/property IDs, not destination names.

## Compatibility and property assignment

Historical San Diego IDs remain fixed aliases: `julian` resolves to `julian-ca`, `east-county` to `east-county-san-diego-ca`, and `san-diego-county` to `san-diego-county-ca`. Every old destination/group ID in the original catalog remains accepted. Responses and new saves use canonical IDs. Do not compare an echoed destination to an old alias without normalizing it; use the returned ID for subsequent requests.

Existing stored assignments are resolved on read, without a database rewrite. Explicit owner assignments still take precedence. Without an assignment, matching uses the saved property city, state/subdivision, and country; an ambiguous match remains unmapped. Historical addresses with no country retain the existing US default, but a missing state does not identify a US town.

County searches use explicit county membership. `san-diego-county-ca` does not include Colorado, Illinois, Texas, or France. Parent-region searches likewise use explicit membership. Current additions outside San Diego have no county assignment; they are included in their documented parent searches only.

The shared catalog is maintained in `wikiuptravel/client/regions.js`. Adding a new area requires a unique qualified ID, display name, country/subdivision, parent, and county membership when known. Add same-name and geographic-isolation tests before release. Do not infer counties from town-name strings or substitute destination centers for property map pins.

## Boulevard and Rancho San Diego

Use `boulevard-ca` or `rancho-san-diego-ca` on both `GET /api/travel/listings` and `GET /api/travel/availability`. The bare aliases `boulevard` and `rancho-san-diego` resolve to the corresponding qualified ID; responses use that canonical ID. Both belong to `east-county-san-diego-ca` and `san-diego-county-ca`. They are excluded from other regional searches.

Registration does not create inventory, approve a partner request, or change an existing property assignment. An authorized search with no eligible properties returns HTTP 200 with an empty result. Unknown IDs still return HTTP 422. Authorization, approval, blacklist, pagination, partial-failure and no-store rules remain unchanged. Verify deployment before relying on these new registrations.

```sh
curl --silent --show-error --fail-with-body --get \
  "$WIKIUP_API_ORIGIN/api/travel/listings" \
  -H "Authorization: Bearer $WIKIUP_API_KEY" \
  -H 'Accept: application/json' \
  --data-urlencode 'destination=boulevard-ca' \
  --data-urlencode 'page=1' --data-urlencode 'pageSize=12' \
  --data-urlencode 'includeImages=false'
```

Repeat with `destination=rancho-san-diego-ca`; use each bare alias to verify canonical `query.destination` output.

## Registered destinations

| ID | Display name | Kind | Parent |
| --- | --- | --- | --- |
| `san-diego-county-ca` | Anywhere in San Diego County | county | — |
| `downtown-airport-san-diego-ca` | Downtown & International Airport | group | san-diego-county-ca |
| `la-jolla-coastal-san-diego-ca` | La Jolla & Coastal Neighborhoods | group | san-diego-county-ca |
| `mission-valley-san-diego-ca` | Mission Valley | group | san-diego-county-ca |
| `coronado-san-diego-ca` | Coronado | group | san-diego-county-ca |
| `north-county-coastal-san-diego-ca` | North County Coastal | group | san-diego-county-ca |
| `north-county-inland-san-diego-ca` | North County Inland | group | san-diego-county-ca |
| `east-county-san-diego-ca` | East County | group | san-diego-county-ca |
| `south-bay-san-diego-ca` | South Bay | group | san-diego-county-ca |
| `colorado-us` | Colorado | group | — |
| `illinois-us` | Illinois | group | — |
| `texas-us` | Texas | group | — |
| `france-fr` | France | group | — |
| `downtown-san-diego-ca` | Downtown San Diego | destination | downtown-airport-san-diego-ca |
| `gaslamp-quarter-ca` | Gaslamp Quarter | destination | downtown-airport-san-diego-ca |
| `little-italy-ca` | Little Italy | destination | downtown-airport-san-diego-ca |
| `east-village-ca` | East Village | destination | downtown-airport-san-diego-ca |
| `embarcadero-ca` | Embarcadero & Marina | destination | downtown-airport-san-diego-ca |
| `harbor-island-ca` | Harbor Island & Airport | destination | downtown-airport-san-diego-ca |
| `balboa-park-ca` | Balboa Park | destination | downtown-airport-san-diego-ca |
| `bankers-hill-ca` | Bankers Hill | destination | downtown-airport-san-diego-ca |
| `hillcrest-ca` | Hillcrest | destination | downtown-airport-san-diego-ca |
| `north-park-ca` | North Park | destination | downtown-airport-san-diego-ca |
| `south-park-ca` | South Park | destination | downtown-airport-san-diego-ca |
| `barrio-logan-ca` | Barrio Logan | destination | downtown-airport-san-diego-ca |
| `university-heights-ca` | University Heights | destination | downtown-airport-san-diego-ca |
| `mission-hills-ca` | Mission Hills | destination | downtown-airport-san-diego-ca |
| `la-jolla-ca` | La Jolla | destination | la-jolla-coastal-san-diego-ca |
| `la-jolla-shores-ca` | La Jolla Shores | destination | la-jolla-coastal-san-diego-ca |
| `bird-rock-ca` | Bird Rock | destination | la-jolla-coastal-san-diego-ca |
| `torrey-pines-ca` | Torrey Pines | destination | la-jolla-coastal-san-diego-ca |
| `university-city-ca` | University City & UTC | destination | la-jolla-coastal-san-diego-ca |
| `pacific-beach-ca` | Pacific Beach | destination | la-jolla-coastal-san-diego-ca |
| `mission-beach-ca` | Mission Beach | destination | la-jolla-coastal-san-diego-ca |
| `mission-bay-ca` | Mission Bay | destination | la-jolla-coastal-san-diego-ca |
| `ocean-beach-ca` | Ocean Beach | destination | la-jolla-coastal-san-diego-ca |
| `point-loma-ca` | Point Loma | destination | la-jolla-coastal-san-diego-ca |
| `liberty-station-ca` | Liberty Station | destination | la-jolla-coastal-san-diego-ca |
| `shelter-island-ca` | Shelter Island | destination | la-jolla-coastal-san-diego-ca |
| `sunset-cliffs-ca` | Sunset Cliffs | destination | la-jolla-coastal-san-diego-ca |
| `hotel-circle-ca` | Mission Valley & Hotel Circle | destination | mission-valley-san-diego-ca |
| `old-town-ca` | Old Town | destination | mission-valley-san-diego-ca |
| `coronado-village-ca` | Coronado Village | destination | coronado-san-diego-ca |
| `silver-strand-ca` | Silver Strand | destination | coronado-san-diego-ca |
| `del-mar-ca` | Del Mar | destination | north-county-coastal-san-diego-ca |
| `solana-beach-ca` | Solana Beach | destination | north-county-coastal-san-diego-ca |
| `cardiff-by-the-sea-ca` | Cardiff-by-the-Sea | destination | north-county-coastal-san-diego-ca |
| `encinitas-ca` | Encinitas | destination | north-county-coastal-san-diego-ca |
| `leucadia-ca` | Leucadia | destination | north-county-coastal-san-diego-ca |
| `carlsbad-ca` | Carlsbad | destination | north-county-coastal-san-diego-ca |
| `oceanside-ca` | Oceanside | destination | north-county-coastal-san-diego-ca |
| `rancho-santa-fe-ca` | Rancho Santa Fe | destination | north-county-coastal-san-diego-ca |
| `escondido-ca` | Escondido | destination | north-county-inland-san-diego-ca |
| `san-pasqual-valley-ca` | San Pasqual Valley | destination | north-county-inland-san-diego-ca |
| `san-marcos-ca` | San Marcos | destination | north-county-inland-san-diego-ca |
| `vista-ca` | Vista | destination | north-county-inland-san-diego-ca |
| `fallbrook-ca` | Fallbrook | destination | north-county-inland-san-diego-ca |
| `bonsall-ca` | Bonsall | destination | north-county-inland-san-diego-ca |
| `valley-center-ca` | Valley Center | destination | north-county-inland-san-diego-ca |
| `pala-ca` | Pala | destination | north-county-inland-san-diego-ca |
| `pauma-valley-ca` | Pauma Valley | destination | north-county-inland-san-diego-ca |
| `palomar-mountain-ca` | Palomar Mountain | destination | north-county-inland-san-diego-ca |
| `rancho-bernardo-ca` | Rancho Bernardo | destination | north-county-inland-san-diego-ca |
| `poway-ca` | Poway | destination | north-county-inland-san-diego-ca |
| `miramar-ca` | Miramar | destination | north-county-inland-san-diego-ca |
| `convoy-district-ca` | Convoy District | destination | north-county-inland-san-diego-ca |
| `julian-ca` | Julian | destination | east-county-san-diego-ca |
| `borrego-springs-ca` | Borrego Springs & Anza-Borrego | destination | east-county-san-diego-ca |
| `mount-laguna-ca` | Mount Laguna | destination | east-county-san-diego-ca |
| `cuyamaca-ca` | Cuyamaca & Lake Cuyamaca | destination | east-county-san-diego-ca |
| `ramona-ca` | Ramona | destination | east-county-san-diego-ca |
| `santa-ysabel-ca` | Santa Ysabel | destination | east-county-san-diego-ca |
| `warner-springs-ca` | Warner Springs | destination | east-county-san-diego-ca |
| `descanso-ca` | Descanso | destination | east-county-san-diego-ca |
| `pine-valley-ca` | Pine Valley | destination | east-county-san-diego-ca |
| `alpine-ca` | Alpine | destination | east-county-san-diego-ca |
| `jamul-ca` | Jamul | destination | east-county-san-diego-ca |
| `la-mesa-ca` | La Mesa | destination | east-county-san-diego-ca |
| `el-cajon-ca` | El Cajon | destination | east-county-san-diego-ca |
| `lakeside-ca` | Lakeside | destination | east-county-san-diego-ca |
| `santee-ca` | Santee | destination | east-county-san-diego-ca |
| `lemon-grove-ca` | Lemon Grove | destination | east-county-san-diego-ca |
| `spring-valley-ca` | Spring Valley | destination | east-county-san-diego-ca |
| `rancho-san-diego-ca` | Rancho San Diego | destination | east-county-san-diego-ca |
| `campo-ca` | Campo & Lake Morena | destination | east-county-san-diego-ca |
| `boulevard-ca` | Boulevard | destination | east-county-san-diego-ca |
| `jacumba-hot-springs-ca` | Jacumba Hot Springs | destination | east-county-san-diego-ca |
| `chula-vista-ca` | Chula Vista | destination | south-bay-san-diego-ca |
| `national-city-ca` | National City | destination | south-bay-san-diego-ca |
| `imperial-beach-ca` | Imperial Beach | destination | south-bay-san-diego-ca |
| `bonita-ca` | Bonita | destination | south-bay-san-diego-ca |
| `san-ysidro-ca` | San Ysidro | destination | south-bay-san-diego-ca |
| `otay-mesa-ca` | Otay Mesa | destination | south-bay-san-diego-ca |
| `aurora-co` | Aurora, Colorado | destination | colorado-us |
| `aurora-il` | Aurora, Illinois | destination | illinois-us |
| `paris-tx` | Paris, Texas | destination | texas-us |
| `paris-fr` | Paris, France | destination | france-fr |
