Skip to main content

​
Overview

Authenticates a user with their email and password. On success, returns a JWT Bearer token you can use to authorize subsequent requests.

​
Request

Method: POST URL: /api/v1/auth/login

​
Headers

HeaderValue
Content-Typeapplication/json

​
Body parameters

​
email
string
required
The email address associated with your account.
​
password
string
required
Your account password.

​
Response

​
access_token
string
The JWT Bearer token to include in the Authorization header of authenticated requests.
​
token_type
string
Always "bearer".

​
Example

curl -X POST https://api.pingback.live/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "password": "securepassword123"
  }'

​
Response example

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

​
Errors

StatusMeaning
401Unauthorized — incorrect email or password
422Validation error — missing required fields