---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Updates the sort order of interim payments by… Reference for the POST
    /projects/{projectId}/interim-payments/sort endpoint in the Leadtime Public
    API API.
sidebar:
  badge: POST
  label: Reorder interim payments
title: Reorder interim payments
type: openapi-operation
---
Updates the sort order of interim payments by providing a new ordered list of payment IDs.

**How reordering works:**
- Provide an array of payment IDs in the desired display order
- The first ID in the array gets sort order 0, the second gets 1, and so on
- Payments not included in the array retain their current sort order
- This affects the order in which payments appear in list responses

**Example:**
To display payments in order: Payment A, Payment C, Payment B
Send: &#123; "paymentIds": ["id-of-A", "id-of-C", "id-of-B"] &#125;

**Validation:**
- All payment IDs must be valid UUIDs
- All payment IDs must belong to the specified project
- Array cannot be empty

**Use cases:**
- Organize payments chronologically (e.g., first payment, second payment, final payment)
- Group related payments together
- Prioritize certain payments in the display

**Permissions:** Requires Projects.edit permission

<Operation source="api-reference" id="projectinterimpaymentscontroller-sortinterimpayments" />
