# List attributed orders

> List recent orders attributed to your integration and the status of your fee on each.

`GET /v2/integrator/orders`

Recent orders attributed to your integration, with the status of your fee on each.

**Authentication:** Required: a **server** [integrator key](https://docs.wagyu.xyz/authentication.md) in `X-Integrator-Key`. A public-client key gets `403`.

This route is not in `openapi.json`. It is documented from Wagyu's key guide; the authentication behaviour below was checked against the live API.

## Response

`200` returns `{ orders }`: recent orders attributed to the integration, across all its keys. Each order carries its fee status:

| Fee status | Meaning |
| --- | --- |
| `none` | No integrator fee applies to this order. |
| `projected` | A fee is expected once the order completes. |
| `paid` | The fee was sent to your payout address. |
| `skipped` | The fee was too small to be worth its own transfer cost. It is not owed. |

## Example

<!-- curl -->
```bash
curl 'https://api-beta.wagyu.xyz/v2/integrator/orders' \
  -H 'x-integrator-key: wg_YOUR_KEY'
```

<!-- Response · 401 without a valid key (checked live) -->
```json
{ "code": "unauthorized", "error": "Authentication required." }
```

---
Source: https://docs.wagyu.xyz/api-reference/list-integrator-orders · Built from the live Wagyu API on 2026-11-04.