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

# Mint Allocation

> Check your ENSC mint allocation

<span style={{ color: "#16a34a" }}>`POST`</span> `/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**

| Name        | Type   | Description                                                         |
| ----------- | ------ | ------------------------------------------------------------------- |
| `recipient` | string | The wallet address for which to check the mint limit or allocation. |

**Example**

<Tabs>
  <Tab title="Mint Allocation Check">
    ```json theme={null}
    {
      "recipient": "0xRecipientAddressABC123"
    }
    ```
  </Tab>

  <Tab title="Response (200) Ok">
    ```json theme={null}
    {
      "status": 200,
      "message": "Mint limit retrieved successfully",
      "data": {
        "address": "0xRecipientAddressABC123",
        "mintLimit": "1000.0",
        "currency": "ENSC"
      }
    }
    ```
  </Tab>
</Tabs>

**Error Responses**

<Tabs>
  <Tab title="Invalid Recipient Address">
    ```json theme={null}
    {
      "status": 400,
      "error": "Invalid Request",
      "message": "Invalid recipient address format",
      "data": null
    }
    ```
  </Tab>

  <Tab title="Recipient Lacks Minting Privileges">
    ```json theme={null}
    {
      "status": 403,
      "error": "Permission Denied",
      "message": "Account lacks minting privileges",
      "data": null
    }
    ```
  </Tab>

  <Tab title="Internal Server Error">
    ```json theme={null}
    {
      "status": 500,
      "error": "Mint Limit Check Failed",
      "message": "Failed to retrieve mint limit",
      "data": null
    }
    ```
  </Tab>
</Tabs>