Skip to main content
GET
/
vault
/
totp
/
{id}
cURL
curl --request GET \
  --url https://api.useanima.sh/v1/vault/totp/{id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "<string>",
  "period": 1
}

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Path Parameters

id
string
required

Credential identifier

Query Parameters

agentId

Agent identifier. Optional when using an agent API key (resolved automatically); required when using a master key.

Pattern: ^[0-9a-z]+$
reveal
boolean
default:false

Return unmasked plaintext fields. Requires master key auth. Audit-logged as 'access_reveal'.

Response

200 - application/json

OK

Time-based one-time password output

code
string
required

Current TOTP code

period
integer
required

Time period in seconds before the code rotates

Required range: x >= 0