---
title: "Get the affiliate checkout link. Does not book."
method: POST
path: "/booking-link"
tags: ["Experiences"]
---

# Get the affiliate checkout link. Does not book.

`POST /booking-link`

## Request

- Base URL: `https://ecoaloha.com/api/v1`
- URL: `https://ecoaloha.com/api/v1/booking-link`
- Auth: none required

Get the affiliate checkout link. Does not book. Requires partner access; returns 503 AGENT_ACCESS_NOT_APPROVED until enabled. Rate limited. Sandbox: X-Sandbox: true returns fixture data.

## Headers

- `X-Sandbox` 'true'
- `Idempotency-Key` string

## Request body

- object
  - `experienceId` string, required: Viator product code, for example 5010SYDNEY.
  - `currency` 'EUR' | 'USD' | 'GBP': Display currency for prices.

## Response `200`

Affiliate link.

- object
  - `data` BookingLink, required
    - `url` string, uri, required: Viator affiliate product page. Booking and payment happen on Viator.
    - `experienceId` string, required: Viator product code, for example 5010SYDNEY.
    - `affiliate` true, required
    - `disclosure` string, required

## Other responses

- `400`: Invalid input.
- `404`: Not found.
- `429`: Rate limited.
- `503`: Partner access is not enabled. The error includes a docs URL.

---

[API](https://skmtc.dev/ecoaloha/apis/ecoaloha-api.md) · [All operations](https://skmtc.dev/ecoaloha/apis/ecoaloha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ecoaloha/apis/ecoaloha-api/revisions/1d423001d484?raw)
