Skip to main content
Most Tether API endpoints require a bearer token.

​
Obtain a token

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

​
Use the token

curl https://your-instance.example.com/api/auth/verify-token \
  -H "Authorization: Bearer <your-jwt-token>"
Do not store long-lived tokens in client-side local storage for public web apps.

​
Common auth issues

  • 401 Unauthorized: token is missing, expired, or malformed.
  • 403 Forbidden: token is valid but lacks required access role.
  • Token from a different environment: staging token used against production API.
For complete API error patterns, see Errors.