auth.v1.MFAService
ListMFAFactors
List the caller's enrolled MFA factors.
Method
POST
Path
auth.v1.MFAService/ListMFAFactors
Service
auth.v1.MFAService
Visibility
Authentication
Session token
MFA Requirement
Not required
POST
auth.v1.MFAService/ListMFAFactors Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/auth.v1.MFAService/ListMFAFactors' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{}'Responses
{
"factors": [
{
"createdAt": "2025-01-01T00:00:00Z",
"factorId": "mfa_33333333333333333333333333333333",
"factorType": "MFA_FACTOR_TYPE_TOTP",
"label": "Primary Authenticator",
"lastUsedAt": "2025-01-01T00:00:00Z"
}
],
"hasRecoveryCodes": false
}Request
auth.v1.ListMFAFactorsRequestResponse
auth.v1.ListMFAFactorsResponse 5 fields
factorId string
MFA factor identifier. Format: "mfa_" followed by 32 lowercase hex characters.
factorType enum
Type of enrolled factor.
MFA_FACTOR_TYPE_TOTP MFA_FACTOR_TYPE_PASSKEY MFA_FACTOR_TYPE_RECOVERY_CODE
label string
Human-friendly label for the factor. Empty when no label is set.
createdAt string (date-time)
Time when the factor was enrolled.
lastUsedAt string (date-time)
Time when the factor was last used. Empty if the factor has not been used.
hasRecoveryCodes boolean
True when the caller has at least one unused recovery code.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |