---
title: "Delete orders"
method: DELETE
path: "/api/v1/orders"
tags: ["Orders"]
---

# Delete orders

`DELETE /api/v1/orders`

## Request

- Base URL: `https://api.reteno.com`
- URL: `https://api.reteno.com/api/v1/orders`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/reteno/apis/reteno-com/docs/api/v1/orders/delete.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint schedules an asynchronous order deletion job.<br/>Supported deletion criteria:<br/>• externalOrderId (deletes the order with the specified externalOrderId), or<br/>• from and to (deletes orders whose occurrence timestamp falls within the specified period).

## Query parameters

- `externalOrderId` string
- `from` string
- `to` string

## Response `200`

Request parameters are valid and the deletion job is accepted for processing

- string

## Other responses

- `400`: Incorrect input data:<br><ul><li>Provide either <code>externalOrderId</code>, or both <code>from</code> and <code>to</code> parameters.</li><li><strong>Invalid date format.</strong> Supported: <code>yyyy-MM-dd'T'HH:mm:ss</code> — e.g. <code>2024-12-31T23:59:59</code> (UTC).</li><li>Start date (<code>from</code>) must be before end date (<code>to</code>).</li><li>Date range cannot exceed <code>24</code> hours.</li></ul>

## Changes

- **2026-11-03** `7e3e7243824f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reteno/apis/reteno-com/changes/api/v1/orders/delete.md)

---

[API](https://skmtc.dev/reteno/apis/reteno-com.md) - [All operations](https://skmtc.dev/reteno/apis/reteno-com/llms.txt) - [OpenAPI document](https://skmtc.dev/reteno/apis/reteno-com/revisions/7e3e7243824f?raw)