---
title: "Request Email Code"
method: POST
path: "/api/v1/console/email-code/request"
tags: ["console"]
---

# Request Email Code

`POST /api/v1/console/email-code/request`

## Request

- Base URL: `https://ndi-api.nace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://ndi-api.nace.ai/api/v1/console/email-code/request`
- Auth: none declared
- TypeScript: <https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/console/email-code/request/post.ts> (a function with typed inputs; its response is checked against the schema)

Mail a sign-in code if this address has a console account. The answer never says whether it does.

## Request body

- EmailCodeRequest: Ask for a sign-in code to be mailed to an address.
  - `email` string, email, required: The console account's email address.

## Response `202`

Successful Response

- EmailCodeRequestAccepted: The same answer whether or not the address has a console account.
  - `expires_in_seconds` integer, required: How long a mailed code stays valid.
  - `resend_after_seconds` integer, required: How long to wait before asking for another code.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `429`: Too many requests for this address or from this network; see Retry-After.
- `500`: Internal Server Error
- `503`: Email sign-in is unavailable (its store is unreachable).

---

[API](https://skmtc.dev/nace/apis/ndi-service.md) - [All operations](https://skmtc.dev/nace/apis/ndi-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-service/revisions/d9d1f8ec2207?raw)