GET /users

List Users

Retrieve a paginated list of all users in the system with optional filtering by status and role

Overview

Returns a paginated list of all users. Use query parameters to control pagination and filtering.

Parameters

Query Parameters

_limit
integer = 10

Maximum number of users to return. Use for pagination.

_start
integer = 0

Number of users to skip. Use with _limit for pagination.

Response

id integer

Unique identifier for the user

name string

Full name of the user

username string

Unique username for the user

email string

Email address of the user

phone string

Phone number of the user

website string

Personal website URL

address object

User’s physical address including street, city, and zipcode

company object

User’s company information including name and catchphrase

Terminal window
curl -X GET "https://jsonplaceholder.typicode.com/users?_limit=10"
const response = await fetch("https://jsonplaceholder.typicode.com/users?_limit=10");
const data = await response.json();
console.log(data);
import requests


response = requests.get(
    "https://jsonplaceholder.typicode.com/users",
    params={"_limit": 10}
)
print(response.json())
[
  {
    "id": 1,
    "name": "Leanne Graham",
    "username": "Bret",
    "email": "[email protected]",
    "phone": "1-770-736-8031 x56442",
    "website": "hildegard.org",
    "address": {
      "street": "Kulas Light",
      "suite": "Apt. 556",
      "city": "Gwenborough",
      "zipcode": "92998-3874"
    },
    "company": {
      "name": "Romaguera-Crona",
      "catchPhrase": "Multi-layered client-server neural-net"
    }
  }
]
Request
curl -X GET "https://jsonplaceholder.typicode.com/users" \
  -H "Content-Type: application/json"
const response = await fetch("https://jsonplaceholder.typicode.com/users", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
},
});

const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://jsonplaceholder.typicode.com/users",
    headers={'Content-Type':'application/json'},
)

print(response.json())
package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "https://jsonplaceholder.typicode.com/users", nil)
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
Response
Send a request to see the response