CursorResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/xpoz-ai/json-schema/xpoz-ai-cursor-response-schema.json",
  "title": "CursorResponse",
  "description": "Envelope for on-demand `/live` endpoints: one provider page plus a cursor.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/xpoz-ai-openapi.json#/components/schemas/CursorResponse",
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Entity shaped by the requested `fields`."
      }
    },
    "count": {
      "type": "integer"
    },
    "dataSource": {
      "$ref": "#/$defs/DataSource"
    },
    "has_more": {
      "type": "boolean"
    },
    "next_page_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "results",
    "count",
    "dataSource",
    "has_more",
    "next_page_cursor"
  ],
  "$defs": {
    "DataSource": {
      "type": "string",
      "enum": [
        "database",
        "api",
        "hybrid"
      ],
      "description": "Where the results came from."
    }
  }
}