> For the complete documentation index, see [llms.txt](https://docs.prosperavest.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prosperavest.com/integrations/publish-your-docs-2/mint-allocation.md).

# Mint Allocation

<mark style="color:green;">`POST`</mark> `/mintLimit`

This endpoint retrieves the mint allocation for a recipient. It verifies the recipient’s address, checks that the account has the minting privilege, and then returns mint limit expressed in the token currency (`ENSC`).

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <api_key>` |

**Body**

<table><thead><tr><th width="173">Name</th><th width="143">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>recipient</code></td><td>string</td><td>The wallet address for which to check the mint limit or allocation.</td></tr></tbody></table>

**Example**

{% tabs %}
{% tab title="Mint Allocation Check" %}

```json
{
  "recipient": "0xRecipientAddressABC123"
}
```

{% endtab %}

{% tab title="Response (200) Ok" %}

```json
{
  "status": 200,
  "message": "Mint limit retrieved successfully",
  "data": {
    "address": "0xRecipientAddressABC123",
    "mintLimit": "1000.0",
    "currency": "ENSC"
  }
}
```

{% endtab %}
{% endtabs %}

**Error Responses**

{% tabs %}
{% tab title="Invalid Recipient Address" %}

```json
{
  "status": 400,
  "error": "Invalid Request",
  "message": "Invalid recipient address format",
  "data": null
}
```

{% endtab %}

{% tab title="Recipient Lacks Minting Privileges" %}

```json
{
  "status": 403,
  "error": "Permission Denied",
  "message": "Account lacks minting privileges",
  "data": null
}
```

{% endtab %}

{% tab title="Internal Server Error" %}

```json
{
  "status": 500,
  "error": "Mint Limit Check Failed",
  "message": "Failed to retrieve mint limit",
  "data": null
}
```

{% endtab %}
{% endtabs %}