API Requests

Authentication

All Ananas GDS API endpoints authenticate via a partnership token. This token is generated automatically when a partnership contract is accepted between an Accommodation and a Tour Operator. The token is unique per partnership and tied to the properties and data types covered by that contract.

The token is passed as a URL path parameter — no separate Authorization header is required.

Finding Your Token

  1. Go to Market & Partners → Contracts.
  2. Open the active contract.
  3. The API token is displayed in the contract detail view.

Keep tokens private. The token grants read access to your partner’s published data. Do not embed tokens in public-facing frontend code — use them in server-side requests only. If a token is compromised, contact support to reset it.

Token Lifecycle

  • Tokens are generated automatically on contract acceptance.
  • Tokens are invalidated when a contract expires or is cancelled.
  • One token per partnership contract. If a contract covers multiple properties, the same token accesses all of them.

Base URL & Formats

All API endpoints use the following base URL:

https://app.hotelfacts.net/api/

All endpoints return JSON by default. XML is also supported by appending ?format=xml to any endpoint URL.

GET https://app.hotelfacts.net/api/facts/published-partners/{token}/
GET https://app.hotelfacts.net/api/facts/published-partners/{token}/?format=xml

Base URL & Formats

All API endpoints use the following base URL:

https://app.hotelfacts.net/api/

All endpoints return JSON by default. XML is also supported by appending ?format=xml to any endpoint URL.

GET https://app.hotelfacts.net/api/facts/published-partners/{token}/
GET https://app.hotelfacts.net/api/facts/published-partners/{token}/?format=xml

API Endpoints

1. Facts Sheet Data

Returns all published fact sheet data for all accommodation properties covered by the contract associated with the provided token.

GET https://app.hotelfacts.net/api/facts/published-partners/{token}/
Parameter
Location
Type
Required
Description
token Path string Required Your partnership API token.
format Query string Optional json (default) or xml
property_id Query string Optional Filter response to a single property by its ID.

2. Property Photos

Returns all published photos for all accommodation properties covered by the contract.

GET https://app.hotelfacts.net/api/facts/partners-photos/{token}/
Parameter
Location
Type
Required
Description
token Path string Required Your partnership API token.
format Query string Optional json (default) or xml
property_id Query string Optional Filter response to a single property by its ID.
category Query string Optional Filter photos by category: exterior, room, pool, restaurant, beach, spa, lobby, other

3. Stop Sale / Availability

Returns the availability calendar data — stop sale, open sale, on-request, and blocked days — for all rooms across all covered properties.

GET https://app.hotelfacts.net/api/stop-sale/StopSale-Export/{token}/
Parameter
Location
Type
Required
Description
token Path string Required Your partnership API token.
format Query string Optional json (default) or xml
property_id Query string Optional Filter to a single property.
date_from Query string Optional Start date filter. Format: YYYY-MM-DD
date_to Query string Optional End date filter. Format: YYYY-MM-DD