# List partner amendments (/docs/api-reference/order-items/list-partner-amendments)

`GET /v1/amendments`

Lists amendments across the authenticated partner's orders.

Requires the read order permission. Includes manual and automatic amendments in all
            statuses. Optional repeated statuses, productType, amendmentMode, orderId, orderItemId and inclusive
            UTC from/to timestamps filter the result. Use flat page (default 1) and limit (default 10,
            maximum 100) query parameters. Nested paging keys return 400 with code 10001.
            Amounts retain their original currency; a quote does not imply settlement.
            Example response:
            ```{"items":[{"id":"b7428a30-f760-46e8-b504-a670bf9bed19","orderId":"a46ee792-287e-44ef-a641-48de1a0f72fd","orderItemId":"cf4a49ac-b785-43d4-912a-4be3443e48bd","productType":"hotel","amendmentMode":"manual","status":"quoted","createdAt":"2026-11-03T09:00:00Z","amountToPay":{"amount":25,"currency":"USD"},"amountToRefund":{"amount":0,"currency":"USD"}}],"pagination":{"currentCount":1,"totalCount":1,"skip":0,"limit":10,"hasMore":false,"page":1,"totalPages":1}}```

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `page` | query | no | `integer` | One-based page number. Default 1. |
| `limit` | query | no | `integer` | Page size, 1 to 100. Default 10. |
| `statuses` | query | no | `string[]` | Repeat to match any of the requested statuses. |
| `productType` | query | no | `string` |  |
| `amendmentMode` | query | no | `string` |  |
| `orderId` | query | no | `string` |  |
| `orderItemId` | query | no | `string` |  |
| `from` | query | no | `string` | Inclusive creation timestamp with UTC offset. ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |
| `to` | query | no | `string` | Inclusive creation timestamp with UTC offset. Send the end of a UTC day to include that whole day. ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |

## Responses

### 200

OK

- `text/plain`: `AmendmentList`
- `application/json`: `AmendmentList`
- `text/json`: `AmendmentList`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 403

Forbidden

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.