Skip to main content

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 the Authorization header:
Always keep your JWT token secure and never expose it in client-side code or public repositories.

Common Headers

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 allowed
    • x-ratelimit-remaining - Remaining requests in current window
    • x-ratelimit-reset - Time when the rate limit resets

Error Responses

Common Status Codes

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