Customer login

This endpoint documentation is generated directly from openapi.yaml.

Endpoint

POST /auth/login

Operation

Operation ID: customerLogin

Authenticate a customer using customer number and password

Authentication

No authentication required.

Request Body

Required: yes.

Content type: application/json

{
  "properties": {
    "customer_number": {
      "description": "Customer's e-conomic customer number",
      "example": 12345,
      "type": "integer"
    },
    "g_recaptcha_response": {
      "description": "reCAPTCHA verification token",
      "type": "string"
    },
    "password": {
      "description": "Customer password",
      "format": "password",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "customer_number",
    "password",
    "g_recaptcha_response"
  ],
  "type": "object"
}
        

Responses

Status	Description	Content Types
200	Login successful	application/json
400
401

Schema for response 200 (application/json):

{
  "oneOf": [
    {
      "properties": {
        "token": {
          "description": "Bearer authentication token",
          "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
          "type": "string"
        }
      },
      "required": [
        "token"
      ],
      "type": "object"
    },
    {
      "properties": {
        "2fa_required": {
          "example": true,
          "type": "boolean"
        },
        "2fa_token": {
          "description": "Temporary 2FA verification token",
          "example": "557a3e7b1a2b...",
          "type": "string"
        }
      },
      "required": [
        "2fa_required",
        "2fa_token"
      ],
      "type": "object"
    }
  ]
}
        

17 March 2026