List approval links

POST

/v2/project/content/listApprovals

List the calling project's approval links with their status, approver and last-opened time — the read behind an approval column in a hotel list or an approval panel on a hotel page. Pass HotelIDs to restrict the list to specific hotels, or omit it to page through every link of the project. Results are ordered by creation time then hotel id. Hotel ids that are not live members of the project are skipped and echoed in NotInProjectIDs. A link that was revoked before its hotel ever approved is excluded, from Data and from Pagination.Total alike; a link revoked after the hotel approved stays listed, carrying RevokedAt and no Token.

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/jsonRequired

Examples

Responses

🟢200

application/json

The page of approval links.

Headers

Bodyapplication/json

🟠400listApprovals_BadRequest

🟠401listApprovals_Unauthorized

🟠403listApprovals_Forbidden

🟠404listApprovals_NotFound

🟠429listApprovals_TooManyRequests

🔴500listApprovals_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Every link of the project, first pageSpecific hotels, one of them not in the project

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

Response Example

200 - Every link of the project, including one revoked after its hotel approved

{
    "Data": [
        {
            "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
            "HotelName": "JAZ Makadina",
            "GiataID": 16706,
            "MasterCode": "HRGD0238",
            "TokenPreview": "QxIpAvQh...",
            "Status": "waiting_for_hotel",
            "Created": false,
            "CreatedBy": "editor@example.com",
            "CreatedAt": "2026-08-25T18:19:17.522006Z",
            "UpdatedAt": "2026-08-25T18:19:17.522006Z"
        },
        {
            "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
            "HotelName": "Sotavento Beach Club",
            "GiataID": 5721,
            "MasterCode": "FUED0009",
            "TokenPreview": "xPBOjXHo...",
            "Status": "approved",
            "ApprovedAt": "2026-08-25T18:19:18.860882Z",
            "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
            "ApprovedBy": {
                "Name": "Ayşe Yılmaz",
                "Email": "ayse@sotavento.example",
                "Phone": "+34 928 000 000"
            },
            "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
            "Created": false,
            "CreatedBy": "editor@example.com",
            "CreatedAt": "2026-08-25T18:19:17.522006Z",
            "UpdatedAt": "2026-08-25T18:19:18.860882Z"
        },
        {
            "HotelID": "019d9c31-77a4-7c19-9d51-2f3b8ac41e77",
            "HotelName": "Rixos Premium Belek",
            "GiataID": 32118,
            "MasterCode": "AYTD0114",
            "TokenPreview": "Lm2VrXe7...",
            "Status": "approved",
            "ApprovedAt": "2026-08-25T18:19:19.104553Z",
            "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
            "ApprovedBy": {
                "Name": "Mehmet Demir",
                "Email": "mehmet@rixos.example",
                "Phone": "+90 242 000 00 00"
            },
            "LastOpenedAt": "2026-08-25T18:19:19.010441Z",
            "RevokedAt": "2026-08-25T18:19:19.602402Z",
            "Created": false,
            "CreatedBy": "editor@example.com",
            "CreatedAt": "2026-08-25T18:19:17.884219Z",
            "UpdatedAt": "2026-08-25T18:19:19.602402Z"
        }
    ],
    "Pagination": {
        "Total": 3,
        "Limit": 100,
        "Offset": 0
    }
}

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

Export approved hotel text with image URLs

Revoke approval link