Overview
The Users & Authentication API provides endpoints for managing user accounts, authentication, and permissions within the Pump.fun platform. These endpoints handle user registration, login/logout operations, profile retrieval, and permission checks.Base URL
Authentication
All endpoints in this section require JWT authentication via theAuthorization header:
Common Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer <JWT> | Yes |
Accept | application/json | Yes |
Origin | https://pump.fun | Yes |
Content-Type | application/json | For POST requests |
Endpoints Overview
Authentication
- POST /auth/login - Authenticate a user and obtain a JWT token
- POST /auth/logout - Invalidate the current user session
- GET /auth/my-profile - Retrieve the authenticated user’s profile information
User Management
- POST /users/register - Register a new user account
- GET /users/ - Retrieve a specific user’s profile by ID
- DELETE /users - Delete the authenticated user’s account
Permissions & Access Control
- GET /auth/is-admin - Check if the authenticated user has admin privileges
- GET /auth/is-super-admin - Check if the authenticated user has super admin privileges
- GET /auth/is-valid-jurisdiction - Verify if the user’s jurisdiction is valid for platform access
Rate Limiting
Authentication endpoints are subject to rate limiting to prevent abuse:- Check response headers for rate limit information:
x-ratelimit-limit- Maximum requests allowedx-ratelimit-remaining- Remaining requests in current windowx-ratelimit-reset- Time when the rate limit resets
Error Responses
Common Status Codes
| Status Code | Description |
|---|---|
200 OK | Request successful |
201 Created | Resource created successfully |
400 Bad Request | Invalid request parameters |
401 Unauthorized | Missing or invalid authentication token |
403 Forbidden | Insufficient permissions |
404 Not Found | User or resource not found |
429 Too Many Requests | Rate limit exceeded |
Next Steps
Get Profile
Retrieve authenticated user profile information
Login
Authenticate users and obtain JWT tokens
Register
Create new user accounts
Permissions
Check user roles and access levels