zklogin.backup

A recovery kit for the signed-in user: issuer, client id, user id, salt and address.

Details

Endpoint: POST /v1/zklogin/backup
Credits: Free
Rate class: Light. Counts against your light requests per second.

Returns a recovery kit as JSON plus a short code. With the kit and their Google account, a user can rebuild their wallet with any standard zkLogin prover, even without tide. Show it to the user to save (a file or a password manager). tide.ad/docs/login/recover checks a kit against a fresh sign-in. Free.

Parameters

Name	Type	Description
jwtrequired	string	The user's ID token (JWT).

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl -X POST "https://api.tide.ad/v1/zklogin/backup" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "jwt": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ii4uLiJ9.eyJpc3MiOiJodHRwczovL2FjY291bnRzLmdvb2dsZS5jb20iLCJhdWQiOiIxMjM0LmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwic3ViIjoiMTEwMDAwMDAwMDAwMDAwMDAwMDAwIiwibm9uY2UiOiIuLi4ifQ.signature"
}'

TypeScript

const res = await fetch("https://api.tide.ad/v1/zklogin/backup", {
  method: "POST",
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "jwt": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ii4uLiJ9.eyJpc3MiOiJodHRwczovL2FjY291bnRzLmdvb2dsZS5jb20iLCJhdWQiOiIxMjM0LmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwic3ViIjoiMTEwMDAwMDAwMDAwMDAwMDAwMDAwIiwibm9uY2UiOiIuLi4ifQ.signature"
  }),
});
const data = await res.json();

Response

JSON

{
  "kit": {
    "version": 1,
    "iss": "https://accounts.google.com",
    "aud": "1234567890-abc.apps.googleusercontent.com",
    "keyClaimName": "sub",
    "sub": "110000000000000000000",
    "salt": "129390038577185583942388216820280642146",
    "address": "0x1c5d8a7a1f2b2b3e9d3b0e3f6a1d0c2b4e5f60718293a4b5c6d7e8f9a0b1c2d3",
    "createdAt": "2026-11-05T07:00:00.000Z"
  },
  "code": "TIDE-...",
  "check": "https://tide.ad/docs/login/recover"
}