DocumentationAPI ReferenceRelease Notes
API Reference

Get the current one-time (TOTP) code for a credential secret

get
https://example.com/api/public/v3/secrets-safe/secrets//totp/code

Returns the current TOTP code and its validity window for the credential with the given secret ID.

Required Permission(s)

Any of the following:

  • Secrets Safe (Read)
  • Workforce Passwords (Read)

API Versions

  • Version 3.3 - Adds TOTP support for credential secrets
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the credential secret

Query Params
string
Defaults to 3.0

API version for response format

Responses

Updated 12 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.