{
  "openapi": "3.1.0",
  "info": {
    "title": "Fun Data Playground static test data API",
    "version": "1.0.0",
    "summary": "Keyless, read-only synthetic JSON fixtures and reference values.",
    "description": "Static files served from a CDN: no key, no sign-up, CORS open. Every record is synthetic and generated from a fixed seed, and a published /v1/ file never changes. There are no query parameters and no write methods. Documentation: https://fundata.dev/fake-data-api"
  },
  "externalDocs": {
    "url": "https://fundata.dev/fake-data-api"
  },
  "servers": [
    {
      "url": "https://fundata.dev"
    }
  ],
  "tags": [
    {
      "name": "fixtures",
      "description": "Synthetic records"
    },
    {
      "name": "reference",
      "description": "Catalogues and reserved values"
    }
  ],
  "paths": {
    "/api/v1/users.json": {
      "get": {
        "operationId": "listUsers",
        "summary": "All 100 users",
        "description": "Fictional people with coherent name, email and gender, and a matching city and country.",
        "tags": [
          "fixtures"
        ],
        "responses": {
          "200": {
            "description": "The full collection, always in id order.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/User"
                  },
                  "minItems": 100,
                  "maxItems": 100
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/users/{id}.json": {
      "get": {
        "operationId": "getUser",
        "summary": "One user by id",
        "tags": [
          "fixtures"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The record.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/User"
                },
                "example": {
                  "id": 1,
                  "firstName": "Anthony",
                  "lastName": "Khan",
                  "email": "anthonykhan@example.org",
                  "gender": "Prefer not to say",
                  "username": "brave_badger576",
                  "phone": "+1 (342) 555-0144",
                  "company": "Pinnacle Solutions",
                  "jobTitle": "Customer Success Manager",
                  "city": "Kuala Lumpur",
                  "country": "Malaysia",
                  "registeredOn": "2025-09-14"
                }
              }
            }
          },
          "404": {
            "description": "No record with that id."
          }
        }
      }
    },
    "/api/v1/products.json": {
      "get": {
        "operationId": "listProducts",
        "summary": "All 100 products",
        "description": "A small catalogue: name, SKU, category, price and stock flag.",
        "tags": [
          "fixtures"
        ],
        "responses": {
          "200": {
            "description": "The full collection, always in id order.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Product"
                  },
                  "minItems": 100,
                  "maxItems": 100
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/products/{id}.json": {
      "get": {
        "operationId": "getProduct",
        "summary": "One product by id",
        "tags": [
          "fixtures"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The record.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Product"
                },
                "example": {
                  "id": 1,
                  "name": "Practical Linen Ball",
                  "sku": "SKU-5780-OB",
                  "category": "Toys",
                  "price": 475.62,
                  "inStock": true
                }
              }
            }
          },
          "404": {
            "description": "No record with that id."
          }
        }
      }
    },
    "/api/v1/orders.json": {
      "get": {
        "operationId": "listOrders",
        "summary": "All 100 orders",
        "description": "Orders whose userId and productId point at records in the two collections above.",
        "tags": [
          "fixtures"
        ],
        "responses": {
          "200": {
            "description": "The full collection, always in id order.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Order"
                  },
                  "minItems": 100,
                  "maxItems": 100
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/orders/{id}.json": {
      "get": {
        "operationId": "getOrder",
        "summary": "One order by id",
        "tags": [
          "fixtures"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The record.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Order"
                },
                "example": {
                  "id": 1,
                  "userId": 48,
                  "productId": 82,
                  "quantity": 5,
                  "status": "refunded",
                  "orderedOn": "2026-03-19"
                }
              }
            }
          },
          "404": {
            "description": "No record with that id."
          }
        }
      }
    },
    "/api/v1/reserved-test-values.json": {
      "get": {
        "operationId": "getReservedTestValues",
        "summary": "Reserved domains, documentation IP ranges and provider test card numbers",
        "tags": [
          "reference"
        ],
        "responses": {
          "200": {
            "description": "Each value with the document that reserves it.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/types.json": {
      "get": {
        "operationId": "getFieldTypes",
        "summary": "The generator's field-type catalogue",
        "tags": [
          "reference"
        ],
        "responses": {
          "200": {
            "description": "Every field type with its options and documentation link.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "User": {
        "title": "User",
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "gender": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "jobTitle": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "registeredOn": {
            "type": "string",
            "format": "date"
          }
        },
        "required": [
          "id",
          "firstName",
          "lastName",
          "email",
          "gender",
          "username",
          "phone",
          "company",
          "jobTitle",
          "city",
          "country",
          "registeredOn"
        ],
        "additionalProperties": false
      },
      "Product": {
        "title": "Product",
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "sku": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "inStock": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "name",
          "sku",
          "category",
          "price",
          "inStock"
        ],
        "additionalProperties": false
      },
      "Order": {
        "title": "Order",
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "userId": {
            "type": "integer"
          },
          "productId": {
            "type": "integer"
          },
          "quantity": {
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "orderedOn": {
            "type": "string",
            "format": "date"
          }
        },
        "required": [
          "id",
          "userId",
          "productId",
          "quantity",
          "status",
          "orderedOn"
        ],
        "additionalProperties": false
      }
    }
  }
}
