List enriched hotel summaries

POST

/v2/project/content/listEnrichedHotelSummaries

Return a paginated lean roster of the calling project's hotels, with optional filters by country, status, full-enrichment flag, text-enrichment state, code kind, a free-text search, the project's internal tags, and external identities (ExternalHotelIDs).

Results are limited to hotels that belong to the calling project. The ExternalHotelIDs filter narrows to hotels matching one of the supplied external-identity selectors; it is intersected with every other filter. Each item is a lightweight summary; fetch a single hotel with the get-enriched-hotel endpoint, or a page of full enriched hotels with list-enriched-hotels.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Project hotel roster retrieved successfully.

Headers

Bodyapplication/json

🟠400listEnrichedHotelSummaries_BadRequest

🟠401listEnrichedHotelSummaries_Unauthorized

🟠403listEnrichedHotelSummaries_Forbidden

🟠404listEnrichedHotelSummaries_NotFound

🟠429listEnrichedHotelSummaries_TooManyRequests

🔴500listEnrichedHotelSummaries_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

First page with default page sizeFilter by country, active status, and a search termRestrict to the project's hotels carrying all of these tagsRestrict to hotels matching either of two external-identity selectors

curl --location 'https://api.ygo.ai/v2/project/content/listEnrichedHotelSummaries' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Limit": 50,
    "Offset": 0
}'

Response Example

200 - A page of enriched hotel summaries

{
    "Data": [
        {
            "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
            "Name": "Bahia Azul Beach Resort",
            "ExternalHotelIDs": {
                "ProductID": "IBS-MAJ-4711",
                "Giata": "668370"
            },
            "GlobalHotelID": "ES-MALLR-K7MP2",
            "Stars": 4,
            "CountryCode": "ES",
            "City": "Palma",
            "CityNames": {
                "en-US": "Palma",
                "de-DE": "Palma"
            },
            "Status": "active",
            "TextEnrichmentStatus": "enriched",
            "LastEnrichedAt": "2026-04-12T09:15:00Z",
            "FullyEnrichedAt": "2026-04-12T09:15:00Z",
            "AttributeCount": 42,
            "RoomCount": 6,
            "ImageCount": 38,
            "CreatedAt": "2026-03-01T08:00:00Z",
            "UpdatedAt": "2026-04-12T09:15:00Z"
        },
        {
            "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
            "Name": "Costa Verde City Hotel",
            "ExternalHotelIDs": {
                "ProductID": "ESVALEN0007",
                "Giata": "7654321"
            },
            "Stars": 3,
            "CountryCode": "ES",
            "City": "Valencia",
            "Status": "draft",
            "TextEnrichmentStatus": "none",
            "AttributeCount": 18,
            "RoomCount": 3,
            "ImageCount": 12,
            "CreatedAt": "2026-03-04T10:30:00Z",
            "UpdatedAt": "2026-03-20T14:05:00Z"
        }
    ],
    "Pagination": {
        "Total": 128,
        "Limit": 50,
        "Offset": 0
    }
}

Modified at 2026-09-14 07:07:44

List enriched hotels

Save text template