> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.resmarksystems.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Resmark API: Orders

An order in Resmark is a completed purchase with associated date/time and customer information. Orders created through the API are automatically marked as paid by an external source. No real payment processing occurs, and customer email notifications are disabled by default.

### Get Orders

```
GET /order
```

Returns a paginated list of orders.

| Parameter | Type | Required | Description |
| ---- |
| limit | number | No | Number of orders to return. Recommended for query performance. Default: 50. |
| page | number | No | Pagination offset. Default: 0. |
| ids | csv | No | Filter by order session ID(s). |
| confirmationIds | csv | No | Filter by order confirmation number(s). |
| fromCreatedDate | string | No | Minimum created date. Format: `YYYY-MM-DD`. |
| toCreatedDate | string | No | Maximum created date. Must be used with `fromCreatedDate`. Format: `YYYY-MM-DD`. |
| fromModifiedDate | string | No | Minimum modified date. Format: `YYYY-MM-DD`. |
| toModifiedDate | string | No | Maximum modified date. Must be used with `fromModifiedDate`. Format: `YYYY-MM-DD`. |
| referenceId | string | No | Filter by the external reference ID used to link Resmark with a third-party system. |
| sortOrder | string | No | Sort by ID. `asc` returns oldest first, `desc` returns newest first. |

### Get Single Order

```
GET /order/{id}
```

Returns a single order including customer info, items with pricing breakdown, and amount paid.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Session ID or Confirmation Number |

### Create New Order

```
POST /order
```

Converts a cart into a completed order. The cart must have inventory added before calling this endpoint.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Cart ID |
| orderId | string | No | If provided, adds the cart contents to an existing order and returns the updated order. |
| billing | object | No | Optional payment memo. Example: `{"memo": "payment received"}` |
| referenceId | string | No | External order ID from a third-party system. |
| disableNotification | boolean | No | Controls product-level notifications. Defaults to `true` (notifications off). |
| disablePendingOrderNotification | boolean | No | Defaults to `true`. |
| disablePendingOrderNotificationResponse | boolean | No | Defaults to `true`. |
| disableConfirmationEmail | boolean | No | Controls whether a confirmation email is sent to the customer. Defaults to `true` (email not sent). Set to `false` to send the confirmation email. |

|| Orders created through the API are automatically marked as paid. No real payment is collected. If you want the customer to receive a confirmation email, set `disableConfirmationEmail` to `false`.

### Create New Reseller Order

```
POST /order
```

Uses the same endpoint and parameters as Create New Order. The difference is that you use a Reseller Cart ID (created through the reseller cart endpoint with `supplierId`) as the `id` parameter.

### Cancel Order

```
DELETE /order/{id}
```

Cancels an entire order and returns all inventory seats to availability.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Order ID or Confirmation ID |
| applyCancellationFee | boolean | No | Set to `false` to suppress cancellation fees. |

### Cancel Inventory Item

```
DELETE /order/{id}/item/{itemId}
```

Cancels a specific date/time from an order that contains multiple items. Useful when the customer needs to cancel one activity but keep the rest of the order.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Order ID or Confirmation ID |
| itemId | string | Yes | Inventory ID for the date/time to cancel |
| applyCancellationFee | boolean | No | Set to `false` to suppress cancellation fees. |

### Cancel Participant

```
DELETE /order/{id}/item/{itemId}/participant/{participantId}
```

Cancels a specific participant from an order item, returning their seat to availability.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Order ID or Confirmation ID |
| itemId | string | Yes | Inventory ID for the date/time |
| participantId | string | Yes | Participant ID from the order's `participantList` (e.g., `HfU`) |
| applyCancellationFee | boolean | No | Set to `false` to suppress cancellation fees. |

### Cancel Unit

```
DELETE /order/{id}/item/{itemId}/unit/{unitId}
```

Cancels a specific unit from an order item. This is used for rental-type products that have a `unitList` instead of a `participantList`.

| Parameter | Type | Required | Description |
| ---- |
| id | string | Yes | Order ID or Confirmation ID |
| itemId | string | Yes | Inventory ID for the date/time |
| unitId | string | Yes | Unit ID from the order's `unitList` (e.g., `HUy`) |
| applyCancellationFee | boolean | No | Set to `false` to suppress cancellation fees. |

### Cancellation Levels

The API provides four levels of cancellation granularity:

1. **Cancel Order** — cancels everything on the order
2. **Cancel Inventory Item** — cancels one date/time from a multi-item order
3. **Cancel Participant** — cancels one person from an activity-type item
4. **Cancel Unit** — cancels one unit from a rental-type item

All cancellation endpoints accept `applyCancellationFee: false` to waive fees. If omitted, the account's configured cancellation policy applies.