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

# Vault check API

> Verify whether a Solana address is a Squads vault

Check if a given address maps to a Squad vault. This endpoint verifies whether a Solana address is a valid Squads V3 or V4 vault account that can receive funds.

## Endpoint

```
https://4fnetmviidiqkjzenwxe66vgoa0soerr.lambda-url.us-east-1.on.aws/isSquad/<ADDRESS>
```

## Quick example

**Request:**

```
https://4fnetmviidiqkjzenwxe66vgoa0soerr.lambda-url.us-east-1.on.aws/isSquad/HFwi9HgNtFcMwNJPHa1czrPhuxeZFZ7G9tPQ1LqAd7sy
```

**Response:**

```json theme={null}
{
  "isSquad": true,
  "version": "v4"
}
```

## Response fields

| Field | Type | Description |
| - | - | - |
| `isSquad` | `boolean` | Whether the address is a valid Squads vault |
| `version` | `string` | Squads program version (`v3`, `v4`, or empty if not a vault) |

## Usage notes

* **ATA validation.** This endpoint does not check for ATA validity. When sending SPL tokens, verify the ATA separately.
* **Rate limit.** 25 requests per second.
* **Frontend usage.** Don't expose the endpoint URL on your frontend. Use SSR or proxy it through your own server.
* **Caching.** Cache responses to avoid polling the same addresses repeatedly.

## Integration examples

<Tabs>
  <Tab title="Basic">
    ```typescript theme={null}
    async function checkVault(address: string): Promise<boolean> {
      const response = await fetch(
        `https://4fnetmviidiqkjzenwxe66vgoa0soerr.lambda-url.us-east-1.on.aws/isSquad/${address}`
      );
      const data = await response.json();
      return data.isSquad;
    }
    ```
  </Tab>

  <Tab title="With caching">
    ```typescript theme={null}
    const vaultCache = new Map<string, { isSquad: boolean; version: string }>();

    async function checkVaultCached(address: string) {
      if (vaultCache.has(address)) {
        return vaultCache.get(address);
      }

      const response = await fetch(
        `https://4fnetmviidiqkjzenwxe66vgoa0soerr.lambda-url.us-east-1.on.aws/isSquad/${address}`
      );
      const data = await response.json();

      vaultCache.set(address, data);
      return data;
    }
    ```
  </Tab>
</Tabs>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.