# Royal Caribbean — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and compare Royal Caribbean cruises by destination, ship, itinerary, and price. Access detailed sailing information including port schedules, voyage durations, and fares across all global routes and departure dates.

**Category:** Travel | **Website:** [royalcaribbean.com/](https://royalcaribbean.com/) | **Docs:** [parse.bot/marketplace/d27a16ca-69d9-4a67-89a3-8ce7c08b26b5/royalcaribbean-com-api](https://parse.bot/marketplace/d27a16ca-69d9-4a67-89a3-8ce7c08b26b5/royalcaribbean-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/royal-caribbean/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get asia pacific world cruise

Search cruises across Far East, South Pacific, and Transpacific destinations, returning detailed itinerary and pricing data for all matching sailings. Fetches search results for these three destinations then enriches each match with full itinerary details including ports and ship info. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/royal-caribbean/get-asia-pacific-world-cruise \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get cruise details

Get detailed information for a specific cruise itinerary, including full port-by-port itinerary with descriptions, ship details, onboard experiences, images, and pricing. Requires a package code and sail date obtained from search_cruises results (encoded in sailings[*].id as 'packageCode_sailDate').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `package_code` | string | Yes | Itinerary package code from search_cruises results. Found in masterSailing.itinerary.code or as the prefix of sailings[*].id before the underscore (e.g. 'FR05W655'). |
| `sail_date` | string | Yes | Sailing date in ISO format YYYY-MM-DD. Found as the suffix of sailings[*].id after the underscore (e.g. '2026-08-31'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/royal-caribbean/get-cruise-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"package_code":"<string>","sail_date":"<string>"}'
```

### Search cruises

Search for cruises with optional filters for destination, ship, and number of nights. Returns paginated results including cruise IDs, itinerary names, ship details, lowest prices, and available sailing dates. Pagination is manual via skip/limit. Each cruise includes a list of sailing IDs that encode the package code and sail date needed for get_cruise_details (format: 'packageCode_YYYY-MM-DD').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | No | Destination code to filter by (e.g. 'CARIB' for Caribbean, 'ALASK' for Alaska, 'FAR.E' for Far East, 'SOPAC' for South Pacific, 'TPACI' for Transpacific, 'EUROP' for Europe). |
| `limit` | integer | No | Maximum number of results to return per page. |
| `nights` | string | No | Number of nights to filter by. Single value (e.g. '7') or range (e.g. '5-9'). |
| `ship` | string | No | Ship code to filter by (e.g. 'FR' for Freedom of the Seas, 'AN' for Anthem of the Seas, 'QN' for Quantum of the Seas). |
| `skip` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/royal-caribbean/search-cruises \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<string>","limit":"<integer>","nights":"<string>","ship":"<string>","skip":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.