---
title: "Iniciar sesión con OTP"
method: POST
path: "/api/v1/sessions"
tags: ["Autenticación y Sesiones"]
---

# Iniciar sesión con OTP

`POST /api/v1/sessions`

## Request

- Base URL: `https://aos.ayenda.co`
- URL: `https://aos.ayenda.co/api/v1/sessions`
- Auth: none required

Valida el OTP y retorna un Bearer token válido por **1 hora**.
El OTP en sí mismo es válido durante **1 hora** desde que fue enviado. Cada inicio de sesión genera un nuevo token e invalida el anterior.

## Request body

- object
  - `phone` string, required
  - `area_code` integer, required: Código de marcación internacional del país (ej. 57 para Colombia, 52 para México). No es un código ISO alfa-2.
  - `otp` string, required

## Response `200`

ok

- object
  - `token` string, required: Token Bearer para peticiones autenticadas. Expira después de 1 hora (TOKEN_TTL). Debe enviarse en el header de autorización así: `Authorization: Bearer <token>`. Se genera un token nuevo en cada inicio de sesión; los tokens anteriores quedan invalidados.

## Other responses

- `401`: unauthorized

---

[API](https://skmtc.dev/loggro/apis/pms-api-v1.md) - [All operations](https://skmtc.dev/loggro/apis/pms-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/pms-api-v1/revisions/42f79a85a9d1?raw)