Get a nonce for a native sign-in

POST /v1/auth/{provider}/nonce

Put the nonce in Google's or Apple's SDK request, then send the ID token with it to POST /v1/auth/{provider}/token. It works once, for 5 minutes.

Path

providerstringrequired

one of: google, apple

Responses

errors: application/problem+json

200

422

Unprocessable Entity

500

Internal Server Error

503

Service Unavailable

Match errors on the problem's code, which stays the same, not on its message.

Send a request

Server

provider path

The request goes from your browser straight to this server; nothing passes through this site. The API must allow this site's origin for CORS.

Requestexample

curl -X POST "$API_URL/v1/auth/$PROVIDER/nonce"

req, err := http.NewRequestWithContext(ctx, http.MethodPost,
	apiURL + "/v1/auth/" + provider + "/nonce", nil)
if err != nil {
	return err
}
res, err := http.DefaultClient.Do(req)
if err != nil {
	return err
}
defer res.Body.Close()

const res = await fetch(`${apiUrl}/v1/auth/${provider}/nonce`, {
  method: "POST",
});
const data = await res.json();

Responseexample

{
  "expires_at": "2026-09-15T12:00:00Z",
  "nonce": "string"
}

{
  "code": "string",
  "status": 422,
  "title": "Unprocessable Entity",
  "detail": "string",
  "errors": [
    {
      "message": "expected length >= 1",
      "location": "body.name"
    }
  ],
  "request_id": "req_9f86d081884c7d65",
  "type": "string"
}