---
title: "Add aliases to existing orders"
method: POST
path: "/orders/aliases"
---

# Add aliases to existing orders

`POST /orders/aliases`

Additively attach alternate order IDs to existing orders. Aliases that already
exist are silently ignored. Orders must already exist.

## Request body

- object
  - `aliases` object[], required
    - `order_id` string, required — The order_id to attach this alias to
    - `type` string, required — Alias type identifier
    - `id` string, required — The alternate order ID value

## Response `200`

Aliases accepted

## Other responses

- `400` — Validation error
- `404` — One or more order_ids not found

---

[API](https://skmtc.net/northbeam/apis/api-spend-v1.md) · [All operations](https://skmtc.net/northbeam/apis/api-spend-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/northbeam/api-spend-v1/versions/ce42b431eeeb/schema)