> This page is for API Reference.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.navipartner.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.navipartner.com/_mcp/server.

# Find Reschedule Options

POST https://api.npretail.app/{tenant}/{environment}/{company}/ticket/reschedule/find
Content-Type: application/json

Returns a confirmed reservation with the slots each admission can move to. The guest picks a slot, then you call [Change Reservation Schedule](./rescheduleChange).

- Send `pinCode` and either `ticketNumber` or `reservationToken`, on every call.
- Find does not reserve the slots it shows. Change checks capacity and rules again, so a slot can be gone when the guest picks it.
- Errors:
  - `404`: wrong identity or pin.
  - `400` `invalid_input`: a bad body or dates.
  - `400` `reschedule_not_allowed`: nothing can move. The message lists the reasons, for example `ALREADY_ADMITTED`, or says that no admission has time slots.
- Protect the guest flow with a dedicated API key and a bot check, for example a CAPTCHA.

Reference: https://docs.navipartner.com/apis/api-reference/ticketing/service-ticket/reschedule-find

## Authentication

- `x-np-api-key` header (required) — API Key authentication via header

## Request

### Path parameters

- `tenant` (string, required) — Your Entra Tenant ID. [More details.](/paths#1-tenant)
- `environment` (string, required) — Your Business Central Environment. [More details.](/paths#2-environment)
- `company` (string, required) — Your Business Central Company. [More details.](/paths#3-company)

### Body (application/json)

This endpoint expects a RescheduleFindRequest.

- `pinCode` (string, required) — A pin code for the ticket, used to authorize rescheduling or revoking a confirmed ticket. Returned only for confirmed reservations. The format is configured per tenant, so do not validate it against a fixed length or pattern.
- `ticketNumber` (string, optional) — An unblocked ticket of the reservation. Send this or `reservationToken`, not both.
- `reservationToken` (string, optional) — The original or a change token of the reservation. Send this or `ticketNumber`, not both.
- `fromDate` (date, optional) — First slot date. Defaults to today (UTC).
- `toDate` (date, optional) — Last slot date. Defaults to `fromDate` plus one month. At most 62 days after `fromDate`.

## Response

### 200

- `reservation` (RescheduleReservation, required)

## Errors

### 400 Bad Request Error

The request is invalid

- `code` (string, required) — A unique identifier for an error
- `message` (string, required) — A description of the error

### 404 Not Found Error

The requested resource was not found

- `code` (string, required) — A unique identifier for an error
- `message` (string, required) — A description of the error

## Types

### RescheduleReservation

- `reservationToken` (string, required) — The original token of the reservation. Use it for change.
- `reservationLines` (list of RescheduleLine, required) — Lines with tickets. A line without tickets, for example a waiting-list line, is left out.

### RescheduleLine

- `systemId` (UUID, required) — Identifies the line in a change request. Replaced on every change of the line.
- `externalLineReference` (integer, required)
- `itemNumber` (string, required) — An item or product number defined in the ticketing system
- `variantCode` (string, required)
- `quantity` (integer, required) — Quantity on the reservation line.
- `validFromDate` (date, required)
- `validToDate` (date, required)
- `admissions` (list of RescheduleAdmission, required)

### RescheduleAdmission

- `admissionCode` (string, required) — A unique code that identifies a specific admission.
- `description` (string, required)
- `currentSchedule` (RescheduleSlot, required) — Dates and times are local to the admission, without a time zone offset.
- `rescheduleAllowed` (boolean, required)
- `reasonCode` (enum, required) — Why the admission cannot move. Empty when `rescheduleAllowed` is `true`.
  - Allowed values: ``, `LINE_AMBIGUOUS`, `TICKET_BLOCKED`, `TICKET_EXPIRED`, `SLOT_CANCELLED`, `NOT_CONFIGURED`, `NOT_ALLOWED`, `ALREADY_ADMITTED`, `CUTOFF_PASSED`, `SLOT_PASSED`, `LINE_NOT_CHANGEABLE`
- `slots` (list of RescheduleSlotWithCapacity, required) — Slots the admission can move to, by start date and time, within the line's `validFromDate` and `validToDate`. Empty when `rescheduleAllowed` is `false`.

### RescheduleSlot

Dates and times are local to the admission, without a time zone offset.

- `scheduleNumber` (integer, required) — The ID of a specific time slot for a specific admission
- `startDate` (date, required)
- `startTime` (string, required)
- `endDate` (date, required)
- `endTime` (string, required)

### RescheduleSlotWithCapacity

- `endDate` (date, required)
- `endTime` (string, required)
- `scheduleNumber` (integer, required) — The ID of a specific time slot for a specific admission
- `startDate` (date, required)
- `startTime` (string, required)
- `remainingCapacity` (integer, optional) — Places left for this line. `null` when no capacity limit applies.

## Examples

**Request**

```json
{
  "pinCode": "1234-5678",
  "reservationToken": "ABC123456DEF789GHI",
  "fromDate": "2026-06-01",
  "toDate": "2026-06-30"
}
```

**Response**

```json
{
  "reservation": {
    "reservationToken": "ABC123456DEF789GHI",
    "reservationLines": [
      {
        "systemId": "6f1c2a9e-3b4d-4e5f-8a7b-1c2d3e4f5a6b",
        "externalLineReference": 1,
        "itemNumber": "31001",
        "variantCode": "",
        "quantity": 2,
        "validFromDate": "2026-06-01",
        "validToDate": "2026-06-30",
        "admissions": [
          {
            "admissionCode": "CASTLE",
            "description": "Castle entrance",
            "currentSchedule": {
              "scheduleNumber": 452,
              "startDate": "2026-06-01",
              "startTime": "10:00:00",
              "endDate": "2026-06-01",
              "endTime": "11:00:00"
            },
            "rescheduleAllowed": true,
            "reasonCode": "",
            "slots": [
              {
                "endDate": "2026-06-02",
                "endTime": "11:00:00",
                "scheduleNumber": 489,
                "startDate": "2026-06-02",
                "startTime": "10:00:00",
                "remainingCapacity": 40
              }
            ]
          }
        ]
      },
      {
        "systemId": "0a9b8c7d-6e5f-4a3b-9c2d-1e0f9a8b7c6d",
        "externalLineReference": 2,
        "itemNumber": "31002",
        "variantCode": "",
        "quantity": 1,
        "validFromDate": "2026-06-01",
        "validToDate": "2026-06-30",
        "admissions": [
          {
            "admissionCode": "MUSEUM",
            "description": "Museum entrance",
            "currentSchedule": {
              "scheduleNumber": 501,
              "startDate": "2026-06-01",
              "startTime": "09:00:00",
              "endDate": "2026-06-01",
              "endTime": "17:00:00"
            },
            "rescheduleAllowed": false,
            "reasonCode": "ALREADY_ADMITTED",
            "slots": []
          }
        ]
      }
    ]
  }
}
```

**SDK Code**

```python Find by reservation token
import requests

url = "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find"

payload = {
    "pinCode": "1234-5678",
    "reservationToken": "ABC123456DEF789GHI",
    "fromDate": "2026-06-01",
    "toDate": "2026-06-30"
}
headers = {
    "x-np-api-key": "<NaviPartner API Key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Find by reservation token
const url = 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find';
const options = {
  method: 'POST',
  headers: {'x-np-api-key': '<NaviPartner API Key>', 'Content-Type': 'application/json'},
  body: '{"pinCode":"1234-5678","reservationToken":"ABC123456DEF789GHI","fromDate":"2026-06-01","toDate":"2026-06-30"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Find by reservation token
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find"

	payload := strings.NewReader("{\n  \"pinCode\": \"1234-5678\",\n  \"reservationToken\": \"ABC123456DEF789GHI\",\n  \"fromDate\": \"2026-06-01\",\n  \"toDate\": \"2026-06-30\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-np-api-key", "<NaviPartner API Key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Find by reservation token
require 'uri'
require 'net/http'

url = URI("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-np-api-key"] = '<NaviPartner API Key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"pinCode\": \"1234-5678\",\n  \"reservationToken\": \"ABC123456DEF789GHI\",\n  \"fromDate\": \"2026-06-01\",\n  \"toDate\": \"2026-06-30\"\n}"

response = http.request(request)
puts response.read_body
```

```java Find by reservation token
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find")
  .header("x-np-api-key", "<NaviPartner API Key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"pinCode\": \"1234-5678\",\n  \"reservationToken\": \"ABC123456DEF789GHI\",\n  \"fromDate\": \"2026-06-01\",\n  \"toDate\": \"2026-06-30\"\n}")
  .asString();
```

```php Find by reservation token
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find', [
  'body' => '{
  "pinCode": "1234-5678",
  "reservationToken": "ABC123456DEF789GHI",
  "fromDate": "2026-06-01",
  "toDate": "2026-06-30"
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-np-api-key' => '<NaviPartner API Key>',
  ],
]);

echo $response->getBody();
```

```csharp Find by reservation token
using RestSharp;

var client = new RestClient("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find");
var request = new RestRequest(Method.POST);
request.AddHeader("x-np-api-key", "<NaviPartner API Key>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"pinCode\": \"1234-5678\",\n  \"reservationToken\": \"ABC123456DEF789GHI\",\n  \"fromDate\": \"2026-06-01\",\n  \"toDate\": \"2026-06-30\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Find by reservation token
import Foundation

let headers = [
  "x-np-api-key": "<NaviPartner API Key>",
  "Content-Type": "application/json"
]
let parameters = [
  "pinCode": "1234-5678",
  "reservationToken": "ABC123456DEF789GHI",
  "fromDate": "2026-06-01",
  "toDate": "2026-06-30"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ticket/reschedule/find")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```