stack/docs-mintlify/api/admin/otp/check-code.mdx
Madison 13fccd32b6
Some checks failed
all-good: Did all the other checks pass? / all-good (push) Has been cancelled
Ensure Prisma migrations are in sync with the schema / check_prisma_migrations (22.x) (push) Has been cancelled
DB migration compat / Check if migrations changed (push) Has been cancelled
Docker Server Build and Push / Docker Build and Push Server (push) Has been cancelled
Docker Server Build and Run / docker (push) Has been cancelled
Runs E2E API Tests (Local Emulator) / E2E Tests (Local Emulator, Node ${{ matrix.node-version }}) (22.x) (push) Has been cancelled
Runs E2E API Tests / E2E Tests (Node ${{ matrix.node-version }}, Freestyle ${{ matrix.freestyle-mode }}) (mock, 22.x) (push) Has been cancelled
Runs E2E API Tests / E2E Tests (Node ${{ matrix.node-version }}, Freestyle ${{ matrix.freestyle-mode }}) (prod, 22.x) (push) Has been cancelled
Runs E2E API Tests with custom port prefix / build (22.x) (push) Has been cancelled
Lint & build / lint_and_build (latest) (push) Has been cancelled
Dev Environment Test With Custom Base Port / restart-dev-and-test-with-custom-base-port (push) Has been cancelled
Dev Environment Test / restart-dev-and-test (push) Has been cancelled
Run setup tests with custom base port / setup-tests-with-custom-base-port (push) Has been cancelled
Run setup tests / setup-tests (push) Has been cancelled
TOC Generator / TOC Generator (push) Has been cancelled
DB migration compat / Back-compat — Current branch migrations with ${{ needs.check-migrations-changed.outputs.base_branch }} branch code (push) Has been cancelled
DB migration compat / Forward-compat — Current branch code with ${{ needs.check-migrations-changed.outputs.base_branch }} branch migrations (push) Has been cancelled
DB migration compat / No migration changes (skipped) (push) Has been cancelled
Add docs-mintlify to root
2026-04-01 14:58:41 -05:00

57 lines
1.6 KiB
Plaintext

---
title: "Check Sign In Code"
description: "Check if a sign in code is valid without using it."
api: "POST /api/v1/auth/otp/sign-in/check-code"
---
## Request
### Headers
<ParamField header="X-Stack-Project-Id" type="string">
The unique identifier of the project.
</ParamField>
<ParamField header="X-Stack-Publishable-Client-Key" type="string">
The publishable client key.
</ParamField>
### Body
<ParamField body="code" type="string" required>
A 45-character verification code. For magic links, this is the code found in the "code" URL query parameter. For OTP, this is formed by concatenating the 6-digit code entered by the user with the nonce (received during code creation).
</ParamField>
## Response
<ResponseField name="is_code_valid" type="boolean" required>
Whether the provided code is valid.
</ResponseField>
<CodeGroup>
```bash cURL
curl -X POST "https://api.stack-auth.com/api/v1/auth/otp/sign-in/check-code" \
-H "Content-Type: application/json" \
-H "X-Stack-Project-Id: <project-id>" \
-H "X-Stack-Publishable-Client-Key: <client-key>" \
-d '{
"code": "u3h6gn4w24pqc8ya679inrhjwh1rybth6a7thurqhnpf2"
}'
```
```javascript JavaScript
const response = await fetch("https://api.stack-auth.com/api/v1/auth/otp/sign-in/check-code", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Stack-Project-Id": "<project-id>",
"X-Stack-Publishable-Client-Key": "<client-key>"
},
body: JSON.stringify({
code: "u3h6gn4w24pqc8ya679inrhjwh1rybth6a7thurqhnpf2"
})
});
const data = await response.json();
```
</CodeGroup>