# Norwegian Cruise Line — 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.

> Browse Norwegian Cruise Line's fleet of ships, search available cruises by destination and sail dates, and view detailed itineraries with ports of call for any sailing. Plan your cruise vacation by comparing ship names, departure dates, and complete port schedules all in one place.

**Category:** Travel | **Website:** [ncl.com/](https://ncl.com/) | **Docs:** [parse.bot/marketplace/c8d4ccd8-d68e-4183-984c-82b03327ba2e/ncl-com-api](https://parse.bot/marketplace/c8d4ccd8-d68e-4183-984c-82b03327ba2e/ncl-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_itinerary_details

Get full details for a specific itinerary, including ship info, ports of call, pricing, and all available sail dates. Combines the search API result with sailing date lookups to provide a comprehensive itinerary view.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `itinerary_code` | string | Yes | The itinerary code to look up (e.g. "GETAWAY4MIANPINASMIA"). Available from search_cruises results as itineraries[*].code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/get_itinerary_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"itinerary_code":"<string>"}'
```

### get_itinerary_sailings

Get all available sailing dates (departure and arrival) for a specific cruise itinerary code. Returns deduplicated sailings with package IDs and stateroom type info. Each sailing includes start/end dates, a package identifier, stateroom category title, and booking status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `guests` | integer | No | Number of guests for pricing availability. |
| `itinerary_code` | string | Yes | The itinerary code to look up (e.g. "GETAWAY4MIANPINASMIA"). Available from search_cruises results as itineraries[*].code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/get_itinerary_sailings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guests":"<integer>","itinerary_code":"<string>"}'
```

### list_destinations

List all cruise destinations offered by NCL. Returns destination codes, names, associated port codes, and available cruise counts. Useful for discovering valid destination filter codes for search_cruises.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/list_destinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_ships

List all Norwegian Cruise Line ships currently in the fleet. Returns ship codes, names, and available cruise counts. Each ship entry includes availability status and the number of cruises currently offered on that vessel.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/list_ships \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_cruises

Search for cruise itineraries with optional filters and pagination. Returns matching itineraries with pricing, ports of call, ship info, and all available filter options. Without filters returns all available cruises sorted by featured weight. Supports filtering by ship codes and destination codes (obtainable from list_ships and list_destinations).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destinations` | string | No | Comma-separated destination codes to filter by (e.g. "ALASKA,CARIBBEAN"). Codes available from list_destinations endpoint. |
| `limit` | integer | No | Maximum number of itineraries to return per page. |
| `offset` | integer | No | Number of itineraries to skip for pagination. |
| `ships` | string | No | Comma-separated ship codes to filter by (e.g. "GETAWAY,PRIMA"). Codes available from list_ships endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncl-com-api-c8d4ccd8/search_cruises \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destinations":"<string>","limit":"<integer>","offset":"<integer>","ships":"<string>"}'
```