# Get an Omnibus Transfer

One sweep or pool withdrawal, as it is now.

## Overview

- The transfer as [List Transfers](https://docs.aureahub.com/docs/structures-transfers-list.md) answers it (A Transfer, there). Follow a withdrawal with it from `queued` to `confirmed` or `failed`.
- Another tenant's, another network's, or an unknown id: `404` `STRUCTURE_NOT_FOUND` (`No such transfer here.`). Until the omnibus processing comes there is none, so every id answers `404`.
- For `owner`, `tenantadmin`, `non_signing_admin`, `signer`, `approver`, `editor`, `viewer` and `auditor`, on their own tenant, with an access token.

## Endpoint

### `GET /v1/structures/{network}/transfers/{transferId}`

Authentication: bearer token required.

One sweep or pool withdrawal of the omnibus.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `network` | string | yes | `mainnet` or `testnet` |
| `transferId` | string (uuid) | yes | The transfer's id |

**Responses**

`200` Sweep

```json
{
  "id": "3d8f139b-71b6-4ca0-8914-c4b8c1b4f898",
  "network": "mainnet",
  "kind": "sweep",
  "status": "confirmed",
  "reason": null,
  "chainId": 8453,
  "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "amount": "310000000",
  "accountId": "3cb0a94e-6358-445d-99a2-021749a80e0a",
  "sourceAccountId": "3cb0a94e-6358-445d-99a2-021749a80e0a",
  "walletId": "b3c7e49b-3606-4a3f-b70e-4b99089e6112",
  "fromAddress": "0x9b110eb821d36a918c1a5d1f2847423b68be6dbd",
  "toAddress": "0xb24cc5e109b3e56860ca0dd97c3688c6e2ad111c",
  "toAccountId": "3e3f3321-a179-423c-b4fb-8a4fe6bc5756",
  "txHash": "0x30058c89ef888bd8abf50907df9613976ed64a32398ce2a1c6c50086ced34c28",
  "nonce": 4,
  "blockNumber": 52418377,
  "fee": "1843200000000",
  "operationId": "aadf3bb5-b2c9-43a6-b196-deff09bc1785",
  "externalId": null,
  "createdAt": "2026-10-13T22:00:03.118Z",
  "updatedAt": "2026-10-13T22:01:04.527Z",
  "sentAt": "2026-10-13T22:00:03.904Z",
  "finishedAt": "2026-10-13T22:01:04.527Z"
}
```

`200` Withdrawal

```json
{
  "id": "482892fb-a38c-4abd-90cd-ea8755233426",
  "network": "mainnet",
  "kind": "withdrawal",
  "status": "confirmed",
  "reason": null,
  "chainId": 8453,
  "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "amount": "125000000",
  "accountId": "f22d2b25-338e-444c-93ef-71693565f346",
  "sourceAccountId": "a9dcb8c6-9bee-4900-b792-cd01bd77820b",
  "walletId": "9ef4730c-d384-4359-b0ed-820e2297b0f9",
  "fromAddress": "0x79c7756b0b77d992feadf0d152503c40de259750",
  "toAddress": "0x16d5a1f0c4ac41af8ca8414a8090069a941de2a2",
  "toAccountId": null,
  "txHash": "0xb4e10c04bdc9f13651394ea7b1f20614dc4876674f45c56841ffed78904a555c",
  "nonce": 17,
  "blockNumber": 52434210,
  "fee": "2104300000000",
  "operationId": "8f61be6a-bbb5-4bda-bc49-9088c89d003d",
  "externalId": "payout-2026-10-14-0042",
  "createdAt": "2026-10-14T06:41:12.330Z",
  "updatedAt": "2026-10-14T06:42:20.871Z",
  "sentAt": "2026-10-14T06:42:10.215Z",
  "finishedAt": "2026-10-14T06:42:20.871Z"
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such transfer here.",
  "details": { "code": "STRUCTURE_NOT_FOUND" }
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/structures/mainnet/transfers/3d8f139b-71b6-4ca0-8914-c4b8c1b4f898 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#structures-transfer-get