SDK / API ReferenceVault
List Credentials
List all credentials in the vault
Scope: vault:read
Returns metadata for all credentials. Secret data is never included.
Request
import { Mailgent } from "@mailgent/sdk";
const mailgent = new Mailgent({ apiKey: process.env.MAILGENT_API_KEY! });
const { credentials, count } = await mailgent.vault.list();import os
from mailgent import Mailgent
mailgent = Mailgent(api_key=os.environ["MAILGENT_API_KEY"])
result = mailgent.vault.list()mailgent vault listvault.list()Available through @mailgent/mcp — see MCP setup.
curl https://api.mailgent.dev/v0/vault \
-H "Authorization: Bearer loid-your-api-key"Response
{
"credentials": [
{
"credentialId": "cred_abc123",
"type": "API_KEY",
"name": "stripe",
"metadata": { "service": "stripe", "prefix": "sk_live_...c123" },
"expired": false,
"expiresAt": null,
"lastUsedAt": "2026-03-30T10:00:00.000Z",
"lastRotatedAt": null,
"createdAt": "2026-03-29T03:00:00.000Z"
}
],
"count": 1
}