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

# Get Secret by Name

> Syteca ACB REST API endpoint to retrieve a secret by its name.

Finds secrets by exact name (case-insensitive), optionally narrowed to a folder by its exact name (case-insensitive). Only secrets the caller has access to are returned.

### Where to get the Secret Name

The Secret name is visible on the **Secrets tab** of the Password Management page.

### Permissions required

The user owning the Access Token must have at least **PAM User** role on the secret.

### Errors

See [Status codes](https://syteca.com/docs/api/acb/api-reference.md#status-codes). Common errors:

* **403 Forbidden** — user lacks at least PAM User role.
* **404 Not Found** — secret doesn't exist or isn't visible.

## Related

> [card] [Get secret credentials](https://syteca.com/docs/api/acb/endpoints/get-secret-credentials.md)
>
> Retrieve the actual password value.

> [card] [Add secret](https://syteca.com/docs/api/acb/endpoints/add-secret.md)
>
> Create a new secret.

> [card] [Heartbeat](https://syteca.com/docs/api/acb/endpoints/heartbeat.md)
>
> Trigger a password validity check.

> [card] [Data models](https://syteca.com/docs/api/acb/data-models.md)
>
> SecretPasswordlessResponseDto schema.


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