User login with password

Authenticates user with email/phone and password. Returns JWT token. If user has multiple companies, returns available companies for selection. If user has single company, automatically selects it for optimal UX.

POST /v1/auth/login

User login with password

cURL

curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "[e-mail]",
  "password": "SecurePassword123!"
}
'

200

{
  "user": {
    "id": "user123",
    "identifiers": [
      {
        "id": "id1",
        "type": "email",
        "value": "[e-mail]",
        "verified": true,
        "created_at": "2024-01-01T00:00:00.000Z",
        "verified_at": "2024-01-01T01:00:00.000Z"
      }
    ],
    "primary_identifier": {
      "id": "id1",
      "type": "email",
      "value": "[e-mail]",
      "verified": true,
      "created_at": "2024-01-01T00:00:00.000Z",
      "verified_at": "2024-01-01T01:00:00.000Z"
    },
    "auth_methods": [
      "password"
    ],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z",
    "roles": [
      {
        "id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
        "name": "admin",
        "permissions": [
          "user.create",
          "user.read",
          "role.create"
        ],
        "created_at": "2024-01-01T00:00:00.000Z",
        "updated_at": "2024-01-01T00:00:00.000Z",
        "description": "Administrator role with full access",
        "company_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
        "organization_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2794"
      }
    ],
    "first_name": "John",
    "last_name": "Doe",
    "suspended_at": "2024-01-01T00:00:00.000Z",
    "metadata": {}
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2024-01-02T00:00:00.000Z",
  "selected_company": {
    "id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
    "name": "My Company",
    "role": "admin"
  }
}

Body

application/json

identifier · string · required

Email or phone number

Example:

"[e-mail]"

password · string<password> · required

User password

Example:

"SecurePassword123!"

Response

200

application/json

Authentication successful

Option 1

Option 2

user · object · required

Show child attributes

token · string · required

JWT authentication token

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

expires_at · string<date-time> · required

Token expiration timestamp

Example:

"2024-01-02T00:00:00.000Z"

selected_company · object

Show child attributes