# Get an Operation by Your Own Id

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The operation your tenant named with its own id, `externalTxId`, with every state it passed.

## Overview

- **Name the operation when you start it**, with the `X-External-Tx-Id` header of the money route that starts it — [Create Transaction](https://docs.aureahub.com/docs/tx-create.md), a swap or a token approval, a dApp broadcast ([Idempotency](https://docs.aureahub.com/docs/idempotency.md) › Your Own Operation Id). The operation keeps it as `externalTxId`; one started without it has `null`.
- **Where your tenant has operation records** [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md) ([Operations & Fees](https://docs.aureahub.com/docs/guide-operations.md)). Otherwise the header is not read and nothing is recorded: this read answers `404` `OPERATION_NOT_FOUND` — use your `Idempotency-Key` meanwhile.
- `externalTxId`: 1 to 255 letters, digits, `_`, `.`, `:` or `-`; unique in your tenant for ever. The same readers and answer as [Get an Operation](https://docs.aureahub.com/docs/operation-get.md) — `events`, `simulations` and `signingChecks` included. `404` `OPERATION_NOT_FOUND` for an id no operation of your tenant holds, or an operation you may not read.

## Endpoint

### `GET /v1/operations/by-external-id/{externalTxId}`

Authentication: bearer token required.

The operation the tenant named with its own id.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `externalTxId` | string | yes | Your id for the operation |

**Responses**

`200` OK

```json
{
  "id": "1d7a3c52-8e4b-4f19-a0c6-2b9e7d5f3a18",
  "type": "TRANSFER",
  "state": "CONFIRMING",
  "subState": "awaiting_confirmation",
  "externalTxId": "payout-2026-10-13-0042",
  "idempotencyKey": "order-7781",
  "…": "the operation as Get an Operation answers it, with events, simulations and signingChecks"
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "Operation not found",
  "details": { "code": "OPERATION_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#operation-by-external-id