> For the complete documentation index, see [llms.txt](https://docs.bankless.com/bankless-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bankless.com/bankless-api/endpoints/claimables.md).

# Claimables

{% hint style="info" %}
**Did you know?** We used the Claimables API to build our very own user-facing Claimables product at [bankless.com/claimables](https://www.bankless.com/claimables). Enter your wallet to see this endpoint working in the real world!
{% endhint %}

### Introduction

This endpoint returns a list of Claimables for a given wallet address, currently supporting EVM, Solana and Cosmos. [Read our FAQs](/bankless-api/useful-resources/faqs.md) to learn more about what Claimables are.

```
GET /claimables/{address}
```

***

### Response Parameters

<table><thead><tr><th width="242">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>type</td><td><code>string</code></td><td>The type of claimable. Options are <code>airdrop</code>, <code>reward</code>, <code>alert</code>, <code>governance-vote</code>, <code>poap</code>, <code>mint</code></td></tr><tr><td>walletAddress</td><td><code>string</code></td><td>The address of the wallet that can claim this asset.</td></tr><tr><td>supplier.name</td><td><code>string</code></td><td>The name of the company or protocol associated with the asset.</td></tr><tr><td>supplier.imageUrl</td><td><code>string</code></td><td>The URL of the image representing the company or protocol.</td></tr><tr><td>title</td><td><code>string</code></td><td>A title of the asset.</td></tr><tr><td>description</td><td><code>string</code></td><td>A description of the asset.</td></tr><tr><td>claimStatus</td><td><code>ClaimStatus</code></td><td>One of three options: <code>claimed</code>, <code>unclaimed</code>, <code>expired</code></td></tr><tr><td>imageUrl</td><td><code>string</code></td><td>The URL of an image that represents the asset.</td></tr><tr><td>action</td><td><code>object</code></td><td>Information about the action available for this opportunity.</td></tr><tr><td>action.type</td><td><code>string</code></td><td>The type of action associated with the asset. Options: <code>claim</code>, <code>vote</code>, <code>alert</code></td></tr><tr><td>action.url</td><td><code>string</code></td><td>The URL to take action on the asset.</td></tr><tr><td>worth.worthUSDFloat</td><td><code>number</code></td><td>The worth of the asset in USD as a float value.</td></tr><tr><td>worth.worthUSDString</td><td><code>string</code></td><td>The worth of the asset in USD as a string value.</td></tr><tr><td>worth.hasWorth</td><td><code>boolean</code></td><td>Indicates if the asset’s worth can be calculated in USD or not.</td></tr><tr><td>expires</td><td><code>number | null</code></td><td>The epoch date of when the asset expires</td></tr><tr><td>tokenAmount</td><td><code>number | undefined</code></td><td>Token amount the wallet is eligible for</td></tr><tr><td>tokenName</td><td><code>string | undefined</code></td><td>Token symbol</td></tr><tr><td>createdAt</td><td><code>number</code></td><td>Unix epoch in milliseconds for when the claimable was added</td></tr></tbody></table>

***

### Example Request

```
curl 'https://api.bankless.com/claimables/0x469b33E0B70725184175750920AfD81B4BD94619'
```

***

### Example Response

```json
[
    {
        "type": "airdrop",
        "title": "Degen Season 1 Airdrop 2",
        "action": {
            "url": "https://www.degen.tips/airdrop2/season2",
            "onEarnifi": false,
            "type": "claim"
        },
        "claimStatus": "expired",
        "description": "Degen's second round of first season airdrops for users who tipped and received tips using $degen on Warpcast.",
        "walletAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "supplier": {
            "name": "Degen",
            "imageUrl": "https://banklesspublic.b-cdn.net/claimables/9jrvP_yG_400x400.jpg"
        },
        "imageUrl": "https://banklesspublic.b-cdn.net/claimables/9jrvP_yG_400x400.jpg",
        "expires": 1711843200000,
        "tokenAmount": 568508,
        "tokenName": "DEGEN",
        "worth": {
            "worthUSDFloat": 12328,
            "worthUSDString": "$12,328",
            "hasWorthInUSD": true
        },
        "created": 1677628800000
    }
]
```

***

### Permissions

This endpoint requires you to have [the **CLAIMABLES** permission](/bankless-api/authentication.md).

***

### Real Use Cases

Here's some real life use cases of products and features using the Claimables API, in production today:

* [Bankless.com/claimables](https://www.bankless.com/claimables) - Claimables is the user-facing version of this API, fully utilising the exact same API documented here to deliver value to over 400,000 Bankless accounts, finding an average of over $800 worth of onchain value for Bankless accounts.
* [Etherscan](https://etherscan.io/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045#cards) - Etherscan built an "Airdrops & Claimables" card to surface all of the unclaimed Claimables on individual wallet pages.
* [Farcaster Frame](https://warpcast.com/bankless/0xca3e17df) - We harnessed the power of the Claimables API into a Farcaster Frame, unlocking real onchain value to numerous Farcaster users.