Practise create-read-update-delete, search boxes and infinite scrolling against a real HTTP API.
Three things every app does and every beginner gets stuck on: saving and editing records, a search box, and loading more items when the user scrolls. These endpoints let you practise all three. /notes answers GET, POST, PUT, PATCH and DELETE like a real backend (nothing is saved), /search searches movies, books, recipes and news at once, and the two pagination endpoints show the two common styles side by side.
const res = await fetch('https://toolorca.com/api/v1/notes?pinned=true&limit=2');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.get(
Uri.parse('https://toolorca.com/api/v1/notes?pinned=true&limit=2'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/notes?pinned=true&limit=2")
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/notes?pinned=true&limit=2")!)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
GET /notes?pinned=true&limit=2
Example response
{
"data": [
{
"id":1,
"userId":1,
"title":"Study plan",
"content":"Buy rice, eggs and morning glory.",
"color":"yellow",
"pinned":true,
"archived":false,
"tags": [
"work"
],
"createdAt":"2025-06-26T10:09:28Z",
"updatedAt":"2025-07-14T10:09:28Z"
},
{
"id":2,
"userId":2,
"title":"App feature ideas",
"content":"Finish the login screen and test on a small phone.",
"color":"purple",
"pinned":true,
"archived":false,
"tags": [
"study"
],
"createdAt":"2025-11-12T21:16:42Z",
"updatedAt":"2025-11-22T21:16:42Z"
}
],
"meta": {
"total":9,
"limit":2,
"skip":0,
"page":1,
"pages":5
}
}
const res = await fetch('https://toolorca.com/api/v1/notes/1');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.get(
Uri.parse('https://toolorca.com/api/v1/notes/1'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/notes/1")
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/notes/1")!)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
Create a note. Returns 201 with the new id. Nothing is saved: the response shows what a real API would return, and the data stays the same for everyone.
Parameter
In
Type
Description
title required
body
string
Note title.
content / color / pinned / tags
body
any
Optional fields.
curl -X POST 'https://toolorca.com/api/v1/notes' \
-H 'Content-Type: application/json' \
-d '{"title":"Buy Kampot pepper","content":"Two bags for the office","color":"green","tags":["shopping"]}'
const res = await fetch('https://toolorca.com/api/v1/notes', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"title": "Buy Kampot pepper",
"content": "Two bags for the office",
"color": "green",
"tags": [
"shopping"
]
}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.post(
Uri.parse('https://toolorca.com/api/v1/notes'),
headers: {'Content-Type': 'application/json'},
body: jsonEncode({
'title': 'Buy Kampot pepper',
'content': 'Two bags for the office',
'color': 'green',
'tags': ['shopping'],
}),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val json = """
{
"title": "Buy Kampot pepper",
"content": "Two bags for the office",
"color": "green",
"tags": [
"shopping"
]
}
""".trimIndent()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/notes")
.post(json.toRequestBody("application/json".toMediaType()))
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
const res = await fetch('https://toolorca.com/api/v1/notes/1', {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"pinned": false,
"color": "blue"
}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.patch(
Uri.parse('https://toolorca.com/api/v1/notes/1'),
headers: {'Content-Type': 'application/json'},
body: jsonEncode({
'pinned': false,
'color': 'blue',
}),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val json = """
{
"pinned": false,
"color": "blue"
}
""".trimIndent()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/notes/1")
.patch(json.toRequestBody("application/json".toMediaType()))
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
const res = await fetch('https://toolorca.com/api/v1/notes/2', {
method: 'DELETE',
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.delete(
Uri.parse('https://toolorca.com/api/v1/notes/2'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/notes/2")
.delete()
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/notes/2")!)
request.httpMethod = "DELETE"
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
DELETE /notes/2
Example response
{
"id":2,
"userId":2,
"title":"App feature ideas",
"content":"Finish the login screen and test on a small phone.",
"color":"purple",
"pinned":true,
"archived":false,
"tags": [
"study"
],
"createdAt":"2025-11-12T21:16:42Z",
"updatedAt":"2025-11-22T21:16:42Z",
"isDeleted":true,
"deletedAt":"2026-11-21T19:15:57Z"
}
const res = await fetch('https://toolorca.com/api/v1/search?q=river&limit=3');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.get(
Uri.parse('https://toolorca.com/api/v1/search?q=river&limit=3'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/search?q=river&limit=3")
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/search?q=river&limit=3")!)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
const res = await fetch('https://toolorca.com/api/v1/pagination/offset?page=2&limit=5');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.get(
Uri.parse('https://toolorca.com/api/v1/pagination/offset?page=2&limit=5'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/pagination/offset?page=2&limit=5")
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/pagination/offset?page=2&limit=5")!)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
const res = await fetch('https://toolorca.com/api/v1/pagination/cursor?limit=5');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import 'dart:convert';
import 'package:http/http.dart' as http;
Future<void> main() async {
final res = await http.get(
Uri.parse('https://toolorca.com/api/v1/pagination/cursor?limit=5'),
);
if (res.statusCode >= 400) throw Exception('HTTP ${res.statusCode}');
final data = jsonDecode(utf8.decode(res.bodyBytes));
print(data);
}
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody
// Call from a background thread or coroutine (Dispatchers.IO), never the main thread.
val client = OkHttpClient()
val request = Request.Builder()
.url("https://toolorca.com/api/v1/pagination/cursor?limit=5")
.build()
client.newCall(request).execute().use { res ->
if (!res.isSuccessful) error("HTTP ${res.code}")
println(res.body?.string())
}
import Foundation
var request = URLRequest(url: URL(string: "https://toolorca.com/api/v1/pagination/cursor?limit=5")!)
let (data, response) = try await URLSession.shared.data(for: request)
guard let http = response as? HTTPURLResponse, http.statusCode < 400 else {
throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))
Offset pagination (page and limit) is simple and lets users jump to page 7, but items can repeat or go missing when the list changes between requests. Cursor pagination only goes forward from the last item you saw, which is what feeds and chat histories use. Try both: build a numbered pager with /pagination/offset and an infinite list with /pagination/cursor.
Free daily limit
Shared with the other mock services: 50 requests per day and 10 per minute per IP address. For unlimited CRUD practice the todos and posts endpoints have a higher limit.
Frequently asked questions
Why does my new note disappear?
Nothing is saved, so every user sees the same data. Keep created notes in your app’s state, as you would with an optimistic update.
What does the Link header look like?
<…/pagination/offset?page=3&limit=5>; rel="next", plus first, prev and last. Many HTTP libraries can parse it for you.
Can I read the Link header from a browser?
Yes. It is listed in Access-Control-Expose-Headers, together with X-Total-Count and the rate-limit headers.
Is the cursor secret?
No, it is just base64url-encoded JSON. Treat it as an opaque string anyway: real APIs change their cursor format.