The OATH Token Resource

The table below documents the fields returned by List OATH Tokens and Get OATH Token. Both endpoints return the identical set of fields for a token — there is no separate brief/full view for this resource.

id

integer

The OneLogin-assigned database ID for this token record.

identifier

string

The token's serial number, as printed on the hardware token. Unique per account.

time_interval

integer

The TOTP time-step interval (in seconds) the token uses to generate a new OTP.

otp_digits

integer

The number of digits in the OTP the token generates.

seed

string

Always returned as the literal masked value *****. The token's real seed value is stored encrypted and is never returned by the API in any response, including immediately after import.

Field names differ between request and response

The Import OATH Tokens request body uses a different, shorter set of field names (id, seed, interval, digits) than the ones returned by List/Get (identifier, seed, time_interval, otp_digits). See the Import page for the exact mapping.

Sample Resource

{
    "id": 918273,
    "identifier": "OATH00112233",
    "time_interval": 30,
    "otp_digits": 6,
    "seed": "*****"
}