Organizations

Overview

The Organizations resource provides fake company data with names, descriptions, industries, sizes, websites, and logos.

Endpoints

Method	Endpoint	Description
GET	/v1/organizations	List all organizations
GET	/v1/organizations/:id	Get a specific organization
GET	/v1/organizations/:id/departments	Get organization's departments
GET	/v1/organizations/:id/employees	Get organization's employees
GET	/v1/organizations/:id/projects	Get organization's projects

Organization Object

{
  "id": 1,
  "name": "Acme Corporation",
  "slug": "acme-corporation",
  "description": "Acme Corporation is a leading provider of innovative solutions.",
  "industry": "Technology",
  "size": "enterprise",
  "website": "https://example.com",
  "logo": "https://example.com/logo.png",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-15T10:30:00.000Z"
}

Field	Type	Description
id	number	Unique identifier
name	string	Organization name
slug	string	URL-friendly unique slug
description	string	Organization description
industry	string	Industry sector
size	string	Organization size
website	string	Website URL
logo	string	Logo image URL
createdAt	string	ISO 8601 timestamp
updatedAt	string	ISO 8601 timestamp

List Organizations

curl https://api.phantomjson.app/v1/organizations

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number
limit	number	20	Items per page (max: 100)
sort	string	—	Sort field and direction
q	string	—	Search query
fields	string	—	Fields to return
industry	string	—	Filter by industry
size	string	—	Filter by size

Response

{
  "data": [
    {
      "id": 1,
      "name": "Acme Corporation",
      "slug": "acme-corporation",
      "industry": "Technology",
      "size": "enterprise"
    }
  ],
  "meta": {
    "total": 20,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Get Organization by ID

curl https://api.phantomjson.app/v1/organizations/1

Response

{
  "data": {
    "id": 1,
    "name": "Acme Corporation",
    "slug": "acme-corporation",
    "description": "Acme Corporation is a leading provider of innovative solutions.",
    "industry": "Technology",
    "size": "enterprise",
    "website": "https://example.com",
    "logo": "https://example.com/logo.png"
  }
}

Get Organization’s Departments

curl https://api.phantomjson.app/v1/organizations/1/departments

Response

{
  "data": [
    {
      "id": 1,
      "organizationId": 1,
      "name": "Engineering",
      "slug": "engineering",
      "description": "Software engineering department"
    }
  ],
  "meta": {
    "total": 5,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Get Organization’s Employees

curl https://api.phantomjson.app/v1/organizations/1/employees

Response

{
  "data": [
    {
      "id": 1,
      "organizationId": 1,
      "firstName": "Alice",
      "lastName": "Johnson",
      "email": "alice@example.com",
      "jobTitle": "Software Engineer"
    }
  ],
  "meta": {
    "total": 50,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Get Organization’s Projects

curl https://api.phantomjson.app/v1/organizations/1/projects

Response

{
  "data": [
    {
      "id": 1,
      "organizationId": 1,
      "name": "Project Alpha",
      "slug": "project-alpha",
      "status": "planning"
    }
  ],
  "meta": {
    "total": 10,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Examples

Search Organizations

curl "https://api.phantomjson.app/v1/organizations?q=acme"

Filter by Industry

curl "https://api.phantomjson.app/v1/organizations?industry=technology"

Filter by Size

curl "https://api.phantomjson.app/v1/organizations?size=enterprise"

Field Selection

curl "https://api.phantomjson.app/v1/organizations?fields=id,name,industry,size"

Combined Query

# Large technology companies sorted by name
curl "https://api.phantomjson.app/v1/organizations?industry=technology&size=enterprise&sort=name:asc&fields=id,name,size"

Industries

Available industry sectors:

• Technology
• Finance
• Healthcare
• Education
• Retail
• Manufacturing
• Energy
• Media
• Agriculture
• Construction
• Transportation
• Hospitality
• Real Estate
• Telecommunications
• Entertainment

Sizes

Available organization sizes:

• startup
• small
• medium
• large
• enterprise

Relations

• Departments — Each organization has many departments (access via /v1/organizations/:id/departments)
• Employees — Each organization has many employees (access via /v1/organizations/:id/employees)
• Teams — Each organization has many teams
• Projects — Each organization has many projects (access via /v1/organizations/:id/projects)