**Source URL:** https://limited.veevavault.dev/vault-api/api-reference/19.1/sandbox-vaults/retrieve-sandbox-entitlements.md

# Retrieve Sandbox Entitlements



Retrieve the total number of available and number of in-use sandbox Vaults for the authenticated Vault.

<Endpoint path="/api/{version}/objects/sandbox_entitlements" method="GET"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v18.2/objects/sandbox_entitlements

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "data": {
        "parent_vault_id": 19523,
        "entitlements": [
            {
                "type": "config",
                "total": 3,
                "in_use": 1
            }
        ]
    }
}

```
</CodeExample>

## Response Details {#response-details}

The response contains the total number of sandbox Vaults available and the number in use for the current Vault. For example, if you have three (3) `total` sandbox Vaults and one (1) `in_use`, your Vault has two (2) more sandboxes available.



---

**Previous:** [Sandbox Vaults](/vault-api/api-reference/19.1/sandbox-vaults)  
**Next:** [Retrieve Sandboxes](/vault-api/api-reference/19.1/sandbox-vaults/retrieve-sandboxes)