Here is the correctly formatted version:


Authentication (v2)

To access Poplidays promotions and booking data, you need to register with the Poplidays REST API service and agree to the Terms of Service.

Registration

Two steps to register:

  1. The Poplidays registration service provides you with a REST API Key {api-key} associated with a signer passphrase {passphrase}.
  2. Add a reference to your REST API Key and sign request parameters using the signer passphrase.

How to Sign Your Request

The signature process is based on Amazon Web Services authentication. Follow the steps below.

Step 1 — Prepare your REST API call

https://api.poplidays.com/v2/stays/search?pageindex=0&pagesize=12&q=hendaye&features=OVEN&features=FREEZER&minprice=100

Step 2 — Combine query path, parameters, and values

All query parameters must be sorted strictly alphabetically by name, without exception. No parameter holds a privileged position in the sort order.

Concatenate the request path with the sorted parameter names and their values to produce the string to be signed.

Note: The client parameter, if present, follows the same alphabetical ordering rule as all other parameters. Any parameter whose name precedes client alphabetically (e.g. apikey, brand) must appear before it in the signature string.

{passphrase}:/v2/stays/search:client:{api-key}:features:FREEZER/OVEN:minprice:100:pageindex:0:pagesize:12:q:hendaye
{passphrase}:/v2/catalog:after=2026-03-26T07:40:30.000:client={api-key}

Step 3 — Hash the combination (SHA-1)

Step 4 — Perform the REST API call

Include your API Key {api-key} and the hashed combination {hashed-combination} as query parameters.

https://api.poplidays.com/v2/stays/search?pageindex=0&pagesize=12&q=hendaye&features=OVEN&features=FREEZER&minprice=100&client={api-key}&signature={hashed-combination}

Note: The Java API client performs this operation for you.