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, and the project's internal tags.

Results are limited to hotels that belong to the calling project. 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 tags

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",
            "GiataID": 1234567,
            "GlobalHotelID": "ES-MALLR-K7MP2",
            "Stars": 4,
            "CountryCode": "ES",
            "City": "Palma",
            "Status": "active",
            "MasterCode": "ESMALLR0001",
            "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",
            "GiataID": 7654321,
            "Stars": 3,
            "CountryCode": "ES",
            "City": "Valencia",
            "Status": "draft",
            "MasterCode": "ESVALEN0007",
            "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-07-01 06:49:44

List enriched hotels

Save text template