---
title: "Complete login with credential"
method: POST
path: "/v1/auth/login/complete"
tags: ["auth"]
---

# Complete login with credential

`POST /v1/auth/login/complete`

Complete the login flow by providing the credential for the selected auth method.

**For email/SMS (cdp_otp)**:
1. Use CDP SDK to authenticate with the identity shown in login/start
2. Provide the CDP token in `cdp_token` field
3. Provide the exact `identity_value` you authenticated with

**For wallet (signature)**:
1. Sign the challenge message from login/start with your wallet
2. Provide the signature in `signature` field
3. Provide the exact `identity_value` (wallet address) you are signing with

On success, returns the Grove API key (JWT).

## Request body

- LoginCompleteRequest — Request model for completing login.
  - `login_token` string, required — Signed session token from login/start
  - `auth_method_type` string, required — Selected authentication method type (email, sms, evm, solana)
  - `identity_value` string, required — Exact identity value for the selected method (email, phone, or wallet address)
  - `cdp_token` string, nullable — CDP Auth token (for email/SMS OTP auth)
  - `signature` string, nullable — Wallet signature of challenge message (for wallet auth)

## Response `200`

Successful Response

- LoginCompleteResponse — Response model for login complete.
  - `account_id` string, required — Account ID
  - `api_key` string, required — Grove API key (JWT)
  - `identity_type` string, required — Primary identity type
  - `identity_value` string, required — Primary identity value
  - `tipping_address` string, required — Server wallet address (for tipping)
  - `onchain_address` string, required

## Other responses

- `400` — Login session expired or invalid credential
- `401` — Credential verification failed
- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/versions/f286b48a8105/schema)