# Read the Omnibus Reconciliation

Per omnibus asset, the last comparison of what the omnibus's wallets hold on chain with what it owes your customers plus the house.

## Overview

- One verdict per chain and asset, replaced at each pass: `status` and `statusCode`; `blockNumber`, the block read; `onChain`, the sum of every member wallet's balance of the asset at that block; `customers`, the sum of the customers' claims; `house`; `difference` = `onChain` − `customers` − `house`; `mismatchSince`, when a mismatch began (`null` otherwise); `checkedAt`.
- **`matched`** (`statusCode` `null`): equal, the house not negative. **`mismatch`**: `DIFFERENCE`, or `HOUSE_NEGATIVE` — the omnibus's fees paid with customers' coins. **`pending`** `IN_FLIGHT`: a transfer of the asset is on its way, the figures not judged. **`unread`**, with no figures: `INBOUND_OFF` (Aurea does not yet follow incoming transfers on this chain), `NO_PLATFORM_NODE` (Aurea has no node of this chain), `NOT_OPENED` (a member wallet not opened for the asset yet), `CHAIN_UNREAD` (a balance could not be read). More: [Account Structures](https://docs.aureahub.com/docs/guide-account-structures.md) › Reconciliation.
- Amounts in the asset's smallest unit, as text. By chain, then asset.
- **Empty until the omnibus processing comes**: `{ "assets": [] }`.
- 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}/reconciliation`

Authentication: bearer token required.

The last reconciliation of each omnibus asset of the network.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `network` | string | yes | `mainnet` or `testnet` |

**Responses**

`200` OK

```json
{
  "assets": [
    {
      "chainId": 8453,
      "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "status": "matched",
      "statusCode": null,
      "blockNumber": 52437518,
      "onChain": "385500000",
      "customers": "385500000",
      "house": "0",
      "difference": "0",
      "mismatchSince": null,
      "checkedAt": "2026-10-14T08:30:41.906Z"
    },
    {
      "chainId": 8453,
      "asset": "native",
      "status": "pending",
      "statusCode": "IN_FLIGHT",
      "blockNumber": 52437518,
      "onChain": "52156800000000000",
      "customers": "4000000000000000",
      "house": "48156800000000000",
      "difference": "0",
      "mismatchSince": null,
      "checkedAt": "2026-10-14T08:30:42.315Z"
    }
  ]
}
```

`200` Unread

```json
{
  "assets": [
    {
      "chainId": 8453,
      "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "status": "unread",
      "statusCode": "INBOUND_OFF",
      "blockNumber": null,
      "onChain": null,
      "customers": null,
      "house": null,
      "difference": null,
      "mismatchSince": null,
      "checkedAt": "2026-10-14T08:30:41.906Z"
    }
  ]
}
```

`200` Not enabled

```json
{
  "assets": []
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/structures/mainnet/reconciliation \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

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