FakeAPI.in
← Back to All APIs

Users API

Complete user management with authentication endpoints

Base URL
https://fakeapi.in/api/users

API Endpoints

GET/api/users
Copy All

Get all users

Parameters

page(number)
Page number (default: 1)
limit(number)
Items per page (default: 10)
GET/api/users/1
Copy All

Get user by ID

Parameters

id(number)
User ID (required)
GET/api/users?q=John
Copy All

Search users by name containing 'John'

Parameters

q(string)
get user by name
GET/api/users?age=25
Copy All

Filter users by age

Parameters

age(string)
get user by age
GET/api/users?gender=male
Copy All

Filter users by gender

Parameters

gender(string)
get user by gender
GET/api/users?company=Acme
Copy All

Filter users by company name

Parameters

company(string)
get user by company name
GET/api/users?jobTitle=Developer
Copy All

Filter users by job title

Parameters

title(string)
get user by Job title
GET/api/users?sortField=name&sortOrder=asc
Copy All

Get users sorted by name ascending

Parameters

sortField(string)
Field to sort by (e.g. name, email)
sortOrder(string)
Order of sorting (asc or desc)
title(string)
Filter users by job title
GET/api/users?sortField=name&sortOrder=desc
Copy All

Get users sorted by name descending

Parameters

sortField(string)
Field to sort by (e.g. name, email)
sortOrder(string)
Order of sorting (asc or desc)
GET/api/users?page=2&limit=10
Copy All

Get users with pagination (page 2, 10 per page)

Parameters

page(number)
Page number for pagination
limit(number)
Number of users per page
GET/api/users?sortField=name&sortOrder=desc&page=2&limit=50
Copy All

Combined filters: search, filter, sort, and paginate users

Parameters

search(string)
Search users by name or email
filter(string)
Filter users by role, status, etc.
sortField(string)
Field to sort by (e.g. name, email)
sortOrder(string)
Order of sorting (asc or desc)
page(number)
Page number for pagination
limit(number)
Number of users per page
POST/api/users
Copy All

Create new user

Parameters

name(string)
Full name of the user
email(string)
Email address of the user
password(string)
Password for the account
role(string)
Role assigned to the user (e.g. admin, user)
title(string)
Job title of the user
PUT/api/users/1
Copy All

Update user (replace all fields)

Parameters

id(number)
User ID to update
name(string)
Updated name
email(string)
Updated email
password(string)
Updated password
role(string)
Updated role
title(string)
Updated job title
PATCH/api/users/1
Copy All

Partially update user (only provided fields will be updated)

Parameters

id(number)
User ID to update
fields(object)
Fields to update (e.g. { name, email })
DELETE/api/users/1
Copy All

Delete user

Parameters

id(number)
User ID to delete

Example Usage

Copy All

import axios from "axios";

const API_URL = process.env.NEXT_PUBLIC_API_URL;

// Get all users
axios
  .get(`${API_URL}api/users`)
  .then(res => console.log("All Users:", res.data))
  .catch(err => console.error(err));

// Create a new user
axios
  .post(`${API_URL}api/users`, {
    name: "John Doe",
    email: "john@example.com"
  })
  .then(res => console.log("User Created:", res.data))
  .catch(err => console.error(err));

Example Response

Copy All
{
      "id": 1,
      "name": "Vicky Oberbrunner II",
      "email": "Alfonzo86@gmail.com",
      "username": "Dwight91",
      "phone": "565-966-0068 x388",
      "website": "https://focused-tapioca.org",
      "address": {
        "street": "106 Cronin Ville",
        "city": "Fort Ashlee",
        "country": "Angola",
        "postalCode": "60837"
      },
      "company": "Bogan - Sanford",
      "jobTitle": "International Marketing Administrator",
      "age": 49,
      "gender": "female",
      "createdAt": "2025-05-19T18:26:28.900Z"
    }

Quick Actions

Test in Playground

API Status

StatusOperational
Rate Limit1000 requests/hour
Response FormatJSON
Users API - Complete User Management Documentation | FakeAPI.in