---
title: "Sign in by email + password"
method: POST
path: "/api/v1/auth/login"
tags: ["Authentication & Billing"]
---

# Sign in by email + password

`POST /api/v1/auth/login`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/auth/login`
- Auth: none declared

Validates email+password against the stored hash and issues a fresh session API key.  Previous keys remain valid (revoke from /me -> rotate if needed).

## Request body

- LoginRequest
  - `email` string, required: Account email
  - `password` string, required: Account password
  - `totp_code` string, nullable: 6-digit authenticator code (only if 2FA is enabled).

## Response `200`

Successful Response

- LoginResponse
  - `api_key` string, required: Fresh session API key. Save it; previous keys remain valid.
  - `key_id` integer, required
  - `email` string, required
  - `name` string, required
  - `tier` string, required
  - `daily_limit` integer, nullable, required
  - `monthly_limit` integer, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)