# List your provisions on any pool

`GET /dex/pools/{poolNft}/provisions` · Lithos client API · Lithos Dex · requires the `api_key` header

Source: https://lithosprotocol.org/docs/api/list-ld-pool-provisions

Every provision on the pool whose `ownerNFT` this wallet holds, including those whose NFT sits in one of its redeem orders there, as `GET /dex/provisions` lists them for ERG:LIT. X is ERG for an ERG/token pool. `claimable*` is what a redeem placement claims from the vault first.

## Parameters

| Name | In | Type | Required | Description |

|---|---|---|---|---|

| `poolNft` | path | string | yes | The pool's NFT id, 64 hex characters |

## Responses

### 200: Provisions held by this wallet on the pool

`LDProvisionList`

- `provisions` (LDProvision[], required)
  - `boxId` (string, required): Provision box id. Changes on every claim and resize.
  - `ownerNFT` (string, required): Token that owns this provision. Unchanged by claims and resizes.
  - `shares` (string, required): LP shares this provision represents. Decimal string.
  - `entryX` (string, required): Accumulator this provision last settled at. Decimal string.
  - `entryY` (string, required): Token side of the same. Decimal string.
  - `value` (string, required): nanoERG held by the provision box. Decimal string.
  - `createdHeight` (integer · int32, required)
  - `shareOfSupply` (number · double, required)
  - `accruedX` (string, required): ERG earned according to the pool, including fees not yet flushed. This is the figure to show a provider as "earned". Decimal string. 
  - `accruedY` (string, required): Token side of the same. Decimal string.
  - `claimableX` (string, required): ERG that can be paid out now. Never negative. Decimal string.
  - `claimableY` (string, required): Token side of the same. Decimal string.
  - `unflushedX` (string, required): accruedX less claimableX — what a flush would release. Decimal string.
  - `unflushedY` (string, required): Token side of the same. Decimal string.
  - `canClaim` (boolean, required): Whether a claim would be accepted right now.
  - `awaitingFlush` (boolean, required): True when nothing can be claimed until the next flush. Normal after a deposit or resize; not an error. 
  - `redeemOrderBoxId` (string): Present when an outstanding redeem order holds this provision's `ownerNFT`. The provision cannot be claimed, resized or redeemed directly until that order fills or is cancelled. 

### 403: Missing or wrong api_key

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### 404: No LithosDex pool with that NFT.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### 503: The pool index is still building, or the node or wallet did not answer. Never returns a partial list.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### default: Error

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

## Example request

```bash
curl -X GET "http://localhost:9000/dex/pools/{poolNft}/provisions" \
  -H "api_key: $LITHOS_API_KEY"
```

## Example response

```json
{
  "provisions": [
    {
      "boxId": "ce00d6e0f4fd3390c0519bb0d24824e1e6b06978163f4845a7cf2c1c7d8f1b65",
      "ownerNFT": "a1f4c2e8b7d93052416fbc8e07d21935a8c4f60b2e91d7385c06a4b1f2e83d97",
      "shares": "12500000000",
      "entryX": "18400000000000000000000000",
      "entryY": "552000000000000000000000",
      "value": "600000000",
      "createdHeight": 1284400,
      "shareOfSupply": 0.0125,
      "accruedX": "292750000",
      "accruedY": "8900000",
      "claimableX": "253000000",
      "claimableY": "7690000",
      "unflushedX": "39750000",
      "unflushedY": "1210000",
      "canClaim": true,
      "awaitingFlush": false,
      "redeemOrderBoxId": "9b41d2f07ce83a5164e2d09fb7a3c1586e04d9b2f71ac8356e0b4d1c7f29a3e5"
    }
  ]
}
```