Documentation

Complete API reference and usage examples

API Status: ● Online
Version: 1.0.0
Resources: 100

Quick Start

Base URL

https://api.mockly.codes

JavaScript/Fetch

JavaScript Fetch
fetch('https://api.mockly.codes/users?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

cURL

Fetch Users
curl "https://api.mockly.codes/users?count=10"

Python

Fetch Users
import requests

response = requests.get('https://api.mockly.codes/users?count=10')
users = response.json()
print(users)

Fresh Data (No Cache)

Bypass Cache
// Get fresh data every time
fetch('https://api.mockly.codes/users?count=10&nocache=true')
  .then(res => res.json())
  .then(data => console.log(data));

Common Endpoints

GET/{resource}

Get a collection of items

Parameters:

  • count (integer) - Number of items to return (default: 10, max: 100)
  • seed (integer) - Seed for reproducible data
  • nocache (boolean) - Bypass cache and generate fresh data (aliases: fresh, _nocache)
GET/{resource}/:id

Get a single item by ID

Parameters:

  • id (integer) - Item ID
  • nocache (boolean) - Bypass cache and generate fresh data (aliases: fresh, _nocache)
GET/{resource}/meta

Get resource metadata and schema

Available Resources

100 resources organized into categories

💼business(12 resources)

clients

clients resource

Properties:

id(integer)
name(string)
contact_person(string)
email(string)
phone(string)
address(string)
city(string)
country(string)
industry(string)
status(string)
contract_value(number)
since(string)

companies

Company information

Properties:

id(integer)
name(string)
slogan(string)
description(string)
industry(string)
size(string)
founded_year(integer)
headquarters(string)
country(string)
website(string)
email(string)
phone(string)
revenue(number)
employees(integer)
logo(string)

contracts

contracts resource

Properties:

id(integer)
contract_number(string)
client_id(integer)
title(string)
description(string)
value(number)
currency(string)
start_date(string)
end_date(string)
status(string)
terms(string)

departments

departments resource

Properties:

id(integer)
name(string)
code(string)
manager_id(integer)
employee_count(integer)
budget(number)
location(string)
description(string)
established(string)

invoices

invoices resource

Properties:

id(integer)
invoice_number(string)
customer_id(integer)
customer_name(string)
customer_email(string)
amount(number)
tax(number)
total(number)
currency(string)
status(string)
issue_date(string)
due_date(string)
paid_at(string)

jobs

Job postings

Properties:

id(integer)
title(string)
company(string)
description(string)
requirements(string)
location(string)
country(string)
type(string)
level(string)
salary_min(integer)
salary_max(integer)
currency(string)
remote(boolean)
posted_at(string)
expires_at(string)

meetings

meetings resource

Properties:

id(integer)
title(string)
description(string)
organizer(string)
start_time(string)
end_time(string)
location(string)
type(string)
attendees_count(integer)
status(string)
online_link(string)
created_at(string)

organizations

organizations resource

Properties:

id(integer)
name(string)
type(string)
description(string)
website(string)
email(string)
phone(string)
address(string)
city(string)
country(string)
employees(integer)
founded(integer)
logo(string)

proposals

proposals resource

Properties:

id(integer)
title(string)
client_id(integer)
description(string)
value(number)
currency(string)
status(string)
submitted_date(string)
valid_until(string)
created_by(string)

reports

reports resource

Properties:

id(integer)
title(string)
type(string)
description(string)
created_by(string)
department(string)
period_start(string)
period_end(string)
status(string)
file_url(string)
created_at(string)

subscriptions

subscriptions resource

Properties:

id(integer)
user_id(integer)
plan(string)
status(string)
price(number)
currency(string)
billing_cycle(string)
start_date(string)
end_date(string)
next_billing_date(string)
auto_renew(boolean)
trial_ends_at(string)

vendors

vendors resource

Properties:

id(integer)
name(string)
contact_person(string)
email(string)
phone(string)
address(string)
city(string)
country(string)
category(string)
rating(number)
active(boolean)

🛒commerce(14 resources)

carts

carts resource

Properties:

id(integer)
user_id(integer)
items(array)
total(number)
currency(string)
status(string)
created_at(string)
updated_at(string)

categories

categories resource

Properties:

id(integer)
name(string)
slug(string)
description(string)
parent_id(integer)
order(integer)
icon(string)
color(string)
items_count(integer)
created_at(string)

coupons

coupons resource

Properties:

id(integer)
code(string)
description(string)
discount_type(string)
discount_value(number)
min_purchase(number)
max_discount(number)
currency(string)
usage_limit(integer)
used_count(integer)
valid_from(string)
valid_until(string)
active(boolean)

discounts

discounts resource

Properties:

id(integer)
code(string)
type(string)
value(number)
minimum_purchase(number)
max_uses(integer)
used_count(integer)
expires_at(string)

inventory

inventory resource

Properties:

id(integer)
product_id(integer)
sku(string)
quantity(integer)
reserved(integer)
location(string)
last_updated(string)

orders

orders resource

Properties:

id(integer)
order_number(string)
customer_id(integer)
customer_name(string)
customer_email(string)
items_count(integer)
subtotal(number)
tax(number)
shipping(number)
total(number)
currency(string)
status(string)
payment_method(string)
shipping_address(string)
created_at(string)
updated_at(string)

payments

payments resource

Properties:

id(integer)
transaction_id(string)
order_id(integer)
customer_id(integer)
amount(number)
currency(string)
method(string)
status(string)
card_last4(string)
card_brand(string)
created_at(string)
processed_at(string)

products

products resource

Properties:

id(integer)- Unique identifier
name(string)- Product name
description(string)- Product description
price(number)- Product price
currency(string)- Price currency
category(string)- Product category
brand(string)- Brand name
sku(string)- Stock keeping unit
stock(integer)- Available quantity
image(string)- Product image URL

promotions

promotions resource

Properties:

id(integer)
title(string)
description(string)
discount_percentage(number)
start_date(string)
end_date(string)
active(boolean)

refunds

refunds resource

Properties:

id(integer)
order_id(integer)
amount(number)
currency(string)
reason(string)
status(string)
processed_date(string)

returns

returns resource

Properties:

id(integer)
order_id(integer)
reason(string)
status(string)
refund_amount(number)
requested_date(string)
processed_date(string)

shippings

shippings resource

Properties:

id(integer)
order_id(integer)
tracking_number(string)
carrier(string)
status(string)
shipped_date(string)
estimated_delivery(string)
address(string)

tags

tags resource

Properties:

id(integer)
name(string)
slug(string)
description(string)
color(string)
usage_count(integer)
created_at(string)

wishlists

wishlists resource

Properties:

id(integer)
user_id(integer)
name(string)
items(array)
is_public(boolean)
created_at(string)

📝content(8 resources)

articles

articles resource

Properties:

id(integer)
title(string)
slug(string)
author(string)
author_id(integer)
content(string)
excerpt(string)
category(string)
tags(array)
status(string)
views(integer)
likes(integer)
comments_count(integer)
featured_image(string)
published_at(string)
updated_at(string)

blogs

blogs resource

Properties:

id(integer)
title(string)
author(string)
content(string)
tags(array)
views(integer)
published_at(string)

documents

documents resource

Properties:

id(integer)
title(string)
type(string)
content(string)
author(string)
version(string)
file_url(string)
created_at(string)

guides

guides resource

Properties:

id(integer)
title(string)
description(string)
category(string)
author(string)
content(string)
tags(array)
published_at(string)

news

news resource

Properties:

id(integer)
headline(string)
summary(string)
content(string)
author(string)
source(string)
category(string)
country(string)
language(string)
tags(array)
image(string)
url(string)
published_at(string)

podcasts

podcasts resource

Properties:

id(integer)
title(string)
description(string)
host(string)
category(string)
episode_number(integer)
season(integer)
duration(integer)- Duration in minutes
release_date(string)
plays(integer)
rating(number)
language(string)
audio_url(string)
cover(string)

posts

Blog posts and articles

Properties:

id(integer)
user_id(integer)
title(string)
body(string)
published(boolean)
created_at(string)
views(integer)
likes(integer)

tutorials

tutorials resource

Properties:

id(integer)
title(string)
description(string)
difficulty(string)
duration(integer)
author(string)
steps(array)
rating(number)

🎓education(1 resources)

courses

courses resource

Properties:

id(integer)
title(string)
description(string)
instructor(string)
category(string)
level(string)
duration(integer)- Duration in hours
lessons(integer)
enrolled(integer)
rating(number)
price(number)
currency(string)
language(string)
certificate(boolean)
thumbnail(string)
created_at(string)

💰finance(6 resources)

accounts

accounts resource

Properties:

id(integer)
account_number(string)
user_id(integer)
balance(number)
currency(string)
type(string)
status(string)

budgets

budgets resource

Properties:

id(integer)
user_id(integer)
category(string)
amount(number)
spent(number)
period(string)
currency(string)

crypto

crypto resource

Properties:

id(integer)
symbol(string)
name(string)
price(number)
change_24h(number)
volume_24h(number)
market_cap(number)
circulating_supply(number)
total_supply(number)
high_24h(number)
low_24h(number)
ath(number)- All-time high
ath_date(string)
rank(integer)
timestamp(string)

currencies

Currency information and exchange rates

Properties:

id(integer)- Currency ID
code(string)- ISO 4217 currency code
name(string)- Currency name
symbol(string)- Currency symbol
exchange_rate(number)- Exchange rate to USD
countries(array)- Countries using this currency
updated_at(string)- Last update time

stocks

stocks resource

Properties:

id(integer)
symbol(string)
name(string)
exchange(string)
price(number)
change(number)
change_percent(number)
volume(integer)
market_cap(number)
high(number)
low(number)
open(number)
previous_close(number)
currency(string)
timestamp(string)

transactions

transactions resource

Properties:

id(integer)
user_id(integer)
amount(number)
currency(string)
type(string)
status(string)
timestamp(string)

🍔food(3 resources)

dishes

dishes resource

Properties:

id(integer)
name(string)
description(string)
cuisine(string)
price(number)
ingredients(array)
rating(number)

ingredients

ingredients resource

Properties:

id(integer)
name(string)
category(string)
unit(string)
calories(integer)
allergens(array)

recipes

recipes resource

Properties:

id(integer)
title(string)
description(string)
cuisine(string)
category(string)
difficulty(string)
prep_time(integer)- Minutes
cook_time(integer)- Minutes
servings(integer)
calories(integer)
rating(number)
author(string)
image(string)
created_at(string)

🌍location(6 resources)

cities

City information

Properties:

id(integer)- City ID
name(string)- City name
country(string)- Country name
country_code(string)- Country ISO code
state(string)- State or province
latitude(number)- Latitude
longitude(number)- Longitude
population(integer)- Population
timezone(string)- Timezone
elevation(integer)- Elevation in meters

coordinates

coordinates resource

Properties:

id(integer)
latitude(number)
longitude(number)
place(string)
elevation(integer)

countries

Country information

Properties:

id(integer)- Country ID
name(string)- Country name
code(string)- ISO 3166-1 alpha-2 code
code3(string)- ISO 3166-1 alpha-3 code
capital(string)- Capital city
region(string)- Geographic region
subregion(string)- Geographic subregion
population(integer)- Population
area(number)- Area in km²
languages(array)- Official languages
currency(string)- Currency code
calling_code(string)- Phone calling code
timezone(string)- Primary timezone
flag(string)- Flag image URL

regions

regions resource

Properties:

id(integer)
name(string)
country(string)
description(string)
area(number)

states

states resource

Properties:

id(integer)
name(string)
code(string)
country(string)
population(integer)
capital(string)

weather

Weather data for locations

Properties:

id(integer)- Weather record ID
city(string)- City name
country(string)- Country name
latitude(number)- Latitude
longitude(number)- Longitude
temperature(number)- Temperature in Celsius
feels_like(number)- Feels like temperature
humidity(integer)- Humidity percentage
pressure(integer)- Atmospheric pressure in hPa
wind_speed(number)- Wind speed in m/s
wind_direction(string)- Wind direction
condition(string)- Weather condition
description(string)- Detailed description
visibility(integer)- Visibility in meters
uv_index(integer)- UV index
timestamp(string)- Observation time

🎬media(10 resources)

albums

albums resource

Properties:

id(integer)
title(string)
artist(string)
genre(string)
release_date(string)
label(string)
tracks(integer)
duration(integer)- Duration in seconds
rating(number)
price(number)
currency(string)
cover(string)

audios

audios resource

Properties:

id(integer)
title(string)
description(string)
duration(integer)
url(string)
format(string)
plays(integer)
created_at(string)

books

books resource

Properties:

id(integer)
title(string)
author(string)
isbn(string)
description(string)
genre(string)
publisher(string)
published_date(string)
pages(integer)
language(string)
price(number)
currency(string)
rating(number)
cover(string)

images

images resource

Properties:

id(integer)
title(string)
description(string)
url(string)
thumbnail_url(string)
width(integer)
height(integer)
size(integer)- Size in bytes
format(string)
tags(array)
photographer(string)
location(string)
uploaded_at(string)

movies

movies resource

Properties:

id(integer)
title(string)
description(string)
director(string)
genre(string)
year(integer)
duration(integer)- Duration in minutes
rating(number)
language(string)
country(string)
budget(number)
revenue(number)
poster(string)
released_at(string)

photos

photos resource

Properties:

id(integer)
title(string)
photographer(string)
url(string)
width(integer)
height(integer)
tags(array)
likes(integer)
uploaded_at(string)

playlists

playlists resource

Properties:

id(integer)
name(string)
description(string)
creator(string)
tracks_count(integer)
followers(integer)
is_public(boolean)
created_at(string)

songs

songs resource

Properties:

id(integer)
title(string)
artist(string)
album(string)
duration(integer)
genre(string)
url(string)
plays(integer)
released_at(string)

streams

streams resource

Properties:

id(integer)
title(string)
streamer(string)
url(string)
viewers(integer)
status(string)
started_at(string)

videos

videos resource

Properties:

id(integer)
title(string)
description(string)
creator(string)
creator_id(integer)
duration(integer)- Duration in seconds
views(integer)
likes(integer)
dislikes(integer)
comments_count(integer)
category(string)
tags(array)
thumbnail(string)
url(string)
published_at(string)

👥people(10 resources)

authors

authors resource

Properties:

id(integer)
name(string)
email(string)
bio(string)
photo(string)
website(string)
books_count(integer)
articles_count(integer)
genres(array)
rating(number)
verified(boolean)

contacts

contacts resource

Properties:

id(integer)
first_name(string)
last_name(string)
email(string)
phone(string)
company(string)
job_title(string)
address(string)
city(string)
country(string)
notes(string)
tags(array)
created_at(string)

customers

customers resource

Properties:

id(integer)
first_name(string)
last_name(string)
email(string)
phone(string)
address(string)
city(string)
country(string)
company(string)
joined_date(string)
lifetime_value(number)
segment(string)

employees

employees resource

Properties:

id(integer)
employee_id(string)
first_name(string)
last_name(string)
email(string)
phone(string)
department(string)
position(string)
hire_date(string)
salary(number)
manager_id(integer)
status(string)

instructors

instructors resource

Properties:

id(integer)
name(string)
email(string)
bio(string)
photo(string)
expertise(array)
courses_count(integer)
students_count(integer)
rating(number)
years_experience(integer)
certifications(array)

mentors

mentors resource

Properties:

id(integer)
name(string)
email(string)
bio(string)
photo(string)
specialization(array)
experience_years(integer)
mentees_count(integer)
rating(number)
hourly_rate(number)
availability(string)

players

players resource

Properties:

id(integer)
name(string)
jersey_number(integer)
position(string)
team_id(integer)
team_name(string)
age(integer)
height(number)- Height in cm
weight(number)- Weight in kg
nationality(string)
goals(integer)
assists(integer)
photo(string)

profiles

profiles resource

Properties:

id(integer)
user_id(integer)
bio(string)
avatar(string)
website(string)
location(string)
occupation(string)
interests(array)
social_links(object)
is_verified(boolean)
followers_count(integer)
following_count(integer)

students

students resource

Properties:

id(integer)
student_id(string)
first_name(string)
last_name(string)
email(string)
phone(string)
date_of_birth(string)
gender(string)
grade(string)
major(string)
gpa(number)
address(string)
city(string)
country(string)
enrolled_date(string)
avatar(string)

users

A user resource

Properties:

id(integer)- Unique identifier
username(string)- Username
email(string)- Email address
first_name(string)
last_name(string)
avatar(string)
gender(string)
phone(string)
address(string)
city(string)
country(string)
created_at(string)

productivity(6 resources)

events

Events and conferences

Properties:

id(integer)
title(string)
description(string)
category(string)
start_date(string)
end_date(string)
location(string)
city(string)
country(string)
venue(string)
organizer(string)
capacity(integer)
price(number)
currency(string)
is_online(boolean)
url(string)

notes

notes resource

Properties:

id(integer)
title(string)
content(string)
author_id(integer)
author(string)
color(string)
tags(array)
pinned(boolean)
archived(boolean)
created_at(string)
updated_at(string)

projects

projects resource

Properties:

id(integer)
name(string)
description(string)
owner(string)
owner_id(integer)
status(string)
priority(string)
budget(number)
currency(string)
start_date(string)
end_date(string)
completion(integer)- Percentage
team_size(integer)
created_at(string)

tasks

tasks resource

Properties:

id(integer)
project_id(integer)
title(string)
description(string)
assignee(string)
assignee_id(integer)
status(string)
priority(string)
due_date(string)
estimated_hours(integer)
actual_hours(integer)
created_at(string)
completed_at(string)

tickets

tickets resource

Properties:

id(integer)
ticket_number(string)
subject(string)
description(string)
customer_id(integer)
customer_name(string)
customer_email(string)
assigned_to(string)
priority(string)
status(string)
category(string)
created_at(string)
updated_at(string)
resolved_at(string)

todos

Todo items for task management

Properties:

id(integer)- Unique identifier
user_id(integer)- Owner user ID
title(string)- Todo title
completed(boolean)- Completion status
due_date(string)- Due date
priority(integer)- Priority level (1-5)

📚reference(3 resources)

faqs

faqs resource

Properties:

id(integer)
question(string)
answer(string)
category(string)
order(integer)
helpful_count(integer)
views(integer)
created_at(string)
updated_at(string)

languages

World languages

Properties:

id(integer)- Language ID
name(string)- Language name
native_name(string)- Native language name
code(string)- ISO 639-1 code
code3(string)- ISO 639-2 code
family(string)- Language family
speakers(integer)- Number of speakers
countries(array)- Countries where spoken

quotes

quotes resource

Properties:

id(integer)
text(string)
author(string)
category(string)
tags(array)
language(string)
likes(integer)
created_at(string)

💬social(9 resources)

comments

Comments on posts

Properties:

id(integer)- Unique identifier
post_id(integer)- Associated post ID
user_id(integer)- Comment author ID
body(string)- Comment text
created_at(string)- Creation timestamp
likes(integer)- Number of likes

followers

followers resource

Properties:

id(integer)
user_id(integer)
follower_id(integer)
followed_at(string)

likes

likes resource

Properties:

id(integer)
user_id(integer)
target_id(integer)
target_type(string)
created_at(string)

mentions

mentions resource

Properties:

id(integer)
user_id(integer)
mentioned_in(integer)
context(string)
created_at(string)

messages

messages resource

Properties:

id(integer)
conversation_id(integer)
sender_id(integer)
sender_name(string)
receiver_id(integer)
receiver_name(string)
content(string)
type(string)
read(boolean)
created_at(string)
read_at(string)

notifications

notifications resource

Properties:

id(integer)
user_id(integer)
title(string)
message(string)
type(string)
priority(string)
read(boolean)
action_url(string)
created_at(string)
read_at(string)

reviews

Product reviews

Properties:

id(integer)- Review ID
product_id(integer)- Product ID
user_id(integer)- Reviewer user ID
rating(integer)- Rating (1-5 stars)
title(string)- Review title
body(string)- Review content
verified_purchase(boolean)- Verified buyer
helpful_count(integer)- Helpful votes
created_at(string)- Review date

shares

shares resource

Properties:

id(integer)
user_id(integer)
content_id(integer)
platform(string)
created_at(string)

testimonials

testimonials resource

Properties:

id(integer)
name(string)
position(string)
company(string)
message(string)
rating(number)
avatar(string)
featured(boolean)
created_at(string)

sports(2 resources)

matches

matches resource

Properties:

id(integer)
home_team(string)
away_team(string)
home_score(integer)
away_score(integer)
sport(string)
league(string)
stadium(string)
city(string)
status(string)
match_date(string)
attendance(integer)

teams

teams resource

Properties:

id(integer)
name(string)
sport(string)
league(string)
founded(integer)
city(string)
country(string)
stadium(string)
coach(string)
wins(integer)
losses(integer)
draws(integer)
logo(string)

✈️travel(10 resources)

attractions

attractions resource

Properties:

id(integer)
name(string)
city(string)
country(string)
type(string)
rating(number)
description(string)

bookings

bookings resource

Properties:

id(integer)
user_id(integer)
type(string)
reference(string)
check_in(string)
check_out(string)
total(number)
status(string)

cars

cars resource

Properties:

id(integer)
make(string)
model(string)
year(integer)
color(string)
vin(string)
type(string)
fuel_type(string)
transmission(string)
mileage(integer)
price(number)
currency(string)
condition(string)
features(array)
image(string)

destinations

destinations resource

Properties:

id(integer)
name(string)
country(string)
description(string)
image(string)
rating(number)
popular(boolean)

flights

flights resource

Properties:

id(integer)
flight_number(string)
airline(string)
origin(string)
origin_code(string)
destination(string)
destination_code(string)
departure_time(string)
arrival_time(string)
duration(integer)- Duration in minutes
aircraft(string)
price(number)
currency(string)
available_seats(integer)
class(string)
status(string)

hotels

hotels resource

Properties:

id(integer)
name(string)
description(string)
stars(integer)
address(string)
city(string)
country(string)
latitude(number)
longitude(number)
phone(string)
email(string)
website(string)
rating(number)
price_per_night(number)
currency(string)
rooms(integer)
amenities(array)
image(string)

properties

properties resource

Properties:

id(integer)
title(string)
description(string)
type(string)
status(string)
address(string)
city(string)
state(string)
country(string)
zip_code(string)
latitude(number)
longitude(number)
price(number)
currency(string)
bedrooms(integer)
bathrooms(integer)
area(number)- Square meters
year_built(integer)
features(array)
image(string)

restaurants

restaurants resource

Properties:

id(integer)
name(string)
description(string)
cuisine(string)
address(string)
city(string)
country(string)
latitude(number)
longitude(number)
phone(string)
email(string)
website(string)
rating(number)
price_range(string)
opening_hours(string)
delivery(boolean)
image(string)

tours

tours resource

Properties:

id(integer)
name(string)
destination(string)
duration(integer)
price(number)
rating(number)
description(string)

travelguides

travelguides resource

Properties:

id(integer)
destination(string)
title(string)
content(string)
tips(array)
author(string)
rating(number)

Features

CORS Enabled

All endpoints support CORS, making them accessible from browser applications.

No Authentication

No API keys or authentication required. Start using immediately.

In-Memory Caching

Fast, consistent responses via pre-warmed cache. Use ?nocache=true to bypass and get fresh data. Check X-Cache header for cache status (HIT/MISS/BYPASS).

Schema-Driven

All resources are defined by JSON schemas. View schemas using the /meta endpoint.

Custom Routes

Resources can define custom paths and aliases in their schemas.

Realistic Data

Uses 50+ generators for names, emails, addresses, dates, and more.

Reproducible

Use the seed parameter to get the same data across requests.