Retrieve hotel incremental dump

ETG API V3

🆕

The Sandbox environment is available exclusively to new partners who begin their integration in Q4 2025.

https://api-sandbox.worldota.net/api/b2b/v3/hotel/info/incremental_dump/

The call gets the dump with the ETG hotels which content has changed in the previous day.

ℹ️

The dump:

Is incremental.
Should be updated every day.

The ETG generates each archive for a single language.

⚠️

Indexing of any internal content such as photos, descriptions and others isn’t allowed.
Any public content such as a name, address, amenities and policies can be indexed.

Sandbox limitations

⚠️

Use all field values and API keys obtained from the sandbox environment only within the sandbox. Don’t mix them with test or production environments.

Request

language. The field value is always en.
inventory. The possible field values:
- all.
- direct.
- preferable.
- direct_fast.

Response

In the dump, the maximum items’ number is 1000.
currency_code. For every object with this field, the value is always EUR.

Request example

curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/hotel/info/incremental_dump/' \
--header 'Content-Type: application/json' \
--data '{
  "language": "en",
  "inventory": "all"
}'

Request body

Expand this| Collapse this

language String required

The language.

ℹ️

The possible values:

ar — Arabic.
bg — Bulgarian.
cs — Czech.
da — Danish.
de — German.
el — Greek.
en — English.
es — Spanish.
fi — Finnish.
fr — French.
he — Hebrew.
hu — Hungarian.
it — Italian.
ja — Japanese.
kk — Kazakh.
ko — Korean.
nl — Dutch.
no — Norwegian Bokmål.
pl — Polish.
pt — Portuguese.
pt_PT — European Portuguese.
ro — Romanian.
ru — Russian.
sq — Albanian.
sr — Serbian.
sv — Swedish.
th — Thai.
tr — Turkish.
uk — Ukrainian.
vi — Vietnamese.
zh_CN — Simplified Chinese.
zh_TW — Traditional Chinese.

inventory String optional

The hotel list to get.

ℹ️

The possible values:
- all — all available suppliers.
- direct — Chains, Extranet, DMC, Switch, Consolidator, Wholesaler.
- direct_fast — Chains, Extranet.
- direct_fast_extended — Chains, Extranet, DMC, Switch.
- preferable — all sellable hotels with availability within last 6 months.
The default value is all.

Response

Expand this| Collapse this

url String

The URL for downloading the dump.

last_update DateTime

The last date and time of updating the dump.

Response example

{
  "data": {
    "last_update": "2025-07-07T20:00:00Z",
    "url": "https://example.com/af/feed_en.json.zst"
  },
  "debug": null,
  "error": null,
  "status": "ok"
}

Errors

The error field has the value specified in the headers below.

`dump_not_ready`

The dump is in processing. Try to send the request later.