> ## Documentation Index
> Fetch the complete documentation index at: https://alguna.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Grants by Wallet

List all credit grants for a specific wallet.

<ParamField path="id" type="string" required>
  The wallet ID.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.alguna.io/wallets/wal_def456/credit-grants \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const grants = await alguna.wallets.listGrants('wal_def456');
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "items": [
      {
        "id": "grant_abc123",
        "wallet_id": "wal_def456",
        "amount": "500.00",
        "description": "Annual credit allocation",
        "expires_at": "2024-12-31T23:59:59Z",
        "status": "active",
        "created_at": "2024-01-20T10:00:00Z"
      },
      {
        "id": "grant_def456",
        "wallet_id": "wal_def456",
        "amount": "100.00",
        "description": "Promotional credits",
        "expires_at": "2024-03-31T23:59:59Z",
        "status": "exhausted",
        "created_at": "2024-01-15T08:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>

<ResponseField name="items" type="array">
  Array of credit grant objects belonging to the wallet.
</ResponseField>

<Note>
  Grants are returned in order of creation, with the most recent first. Use this endpoint to track all credit sources for a wallet.
</Note>