PropperDocs

Your recovery codes

.md

The codes that sign you in once each without your authenticator.

Scopesme:write
GET/v1/me/two-factor/recovery-codes

The recovery codes as they stand, each good for one sign-in without the authenticator. A used one is replaced by a new one.

This read takes me:write, because holding these codes is as good as holding the second factor.

Request

curl https://api.proppertrading.com/v1/me/two-factor/recovery-codes \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"

Response

{
    "data": {
        "object": "recovery_codes",
        "codes": [
            "Jy9hX6BD6l-lYhIP6Ntnz",
            "8LXgjpnR6t-prfYWRTUew",
            "RoG7CwJrOh-87xXtpj7J4",
            "JzhugBEBDE-u01QrIF8i0",
            "LYVFPDTuO9-FKLEPPim4M",
            "2EaKE8LlYB-ulwtc6u5gU",
            "EwVkoPyHrP-TEqmVABcQp",
            "9c0OGu65f3-sLKc579im1"
        ]
    },
    "meta": { "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey" }
}

Errors

StatusCodeMeaning
400two_factor_not_enabledThe account has no authenticator, so no codes
403insufficient_scopeThis device does not hold me:write