Filter one supported public reference dataset using its typed fields. Requires a dataset and optional bounded filters, ordering and cursor. Returns matching rows, exact source versions and decimal strings without SQL, cross-unit arithmetic, writes or charges. Source changes expire paging cursors.
View input schema
{
"type": "object",
"properties": {
"dataset": {
"anyOf": [
{
"type": "string",
"const": "http-status-codes",
"description": "Query the public HTTP status-code reference dataset."
},
{
"type": "string",
"const": "periodic-table",
"description": "Query the public periodic-table reference dataset."
},
{
"type": "string",
"const": "codata-constants",
"description": "Query the public CODATA constants reference dataset."
}
],
"description": "Public reference dataset to query: HTTP status codes, periodic-table elements or CODATA constants."
},
"filters": {
"anyOf": [
{
"default": [],
"description": "Up to eight HTTP field comparisons, combined with AND.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"const": "code",
"description": "HTTP status code field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"gte",
"lte"
],
"description": "Integer equality, lower bound or upper bound comparison."
},
"value": {
"type": "integer",
"minimum": 100,
"maximum": 599,
"description": "HTTP status code from 100 to 599 to compare."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"reason",
"class_name"
],
"description": "HTTP reason phrase or response class field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Text to compare against the selected HTTP field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
},
{
"default": [],
"description": "Up to eight element field comparisons, combined with AND.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"atomic_number",
"group",
"period"
],
"description": "Periodic-table integer field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"gte",
"lte"
],
"description": "Integer equality, lower bound or upper bound comparison."
},
"value": {
"type": "integer",
"minimum": 1,
"maximum": 118,
"description": "Integer to compare against the selected element field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"name",
"symbol",
"standard_state"
],
"description": "Periodic-table text field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Text to compare against the selected element field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
},
{
"default": [],
"description": "Up to eight CODATA field comparisons, combined with AND; cross-unit numeric comparisons are unsupported.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"quantity",
"unit"
],
"description": "CODATA quantity name or source-reported unit field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Text to compare against the selected CODATA field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"exact",
"truncated"
],
"description": "Whether the source declares an exact value or truncates its reported digits."
},
"operator": {
"type": "string",
"const": "eq",
"description": "Boolean equality; numeric comparisons are unsupported."
},
"value": {
"type": "boolean",
"description": "Boolean value required for the selected source-status field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
}
],
"description": "Up to eight field comparisons for the selected dataset, combined with AND. Cross-unit numeric comparisons are unsupported."
},
"order_by": {
"anyOf": [
{
"default": "code",
"description": "HTTP field used to order rows.",
"type": "string",
"enum": [
"code",
"reason"
]
},
{
"default": "atomic_number",
"description": "Element field used to order rows.",
"type": "string",
"enum": [
"atomic_number",
"name",
"symbol",
"group",
"period"
]
},
{
"default": "quantity",
"description": "CODATA field used to order rows.",
"type": "string",
"enum": [
"quantity",
"unit"
]
}
],
"description": "Field from the selected dataset used to order reference rows."
},
"direction": {
"default": "asc",
"description": "Ascending or descending row ordering.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"default": 20,
"description": "Maximum reference rows to return in this page, from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque next_cursor from the same dataset, filters, ordering and source snapshot.",
"type": "string",
"maxLength": 2048
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"dataset": {
"type": "string",
"const": "http-status-codes",
"description": "Query the public HTTP status-code reference dataset."
},
"filters": {
"default": [],
"description": "Up to eight HTTP field comparisons, combined with AND.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"const": "code",
"description": "HTTP status code field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"gte",
"lte"
],
"description": "Integer equality, lower bound or upper bound comparison."
},
"value": {
"type": "integer",
"minimum": 100,
"maximum": 599,
"description": "HTTP status code from 100 to 599 to compare."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"reason",
"class_name"
],
"description": "HTTP reason phrase or response class field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Text to compare against the selected HTTP field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
},
"order_by": {
"default": "code",
"description": "HTTP field used to order rows.",
"type": "string",
"enum": [
"code",
"reason"
]
},
"direction": {
"default": "asc",
"description": "Ascending or descending row ordering.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"default": 20,
"description": "Maximum reference rows to return in this page, from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque next_cursor from the same dataset, filters, ordering and source snapshot.",
"type": "string",
"maxLength": 2048
}
},
"required": [
"dataset"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"dataset": {
"type": "string",
"const": "periodic-table",
"description": "Query the public periodic-table reference dataset."
},
"filters": {
"default": [],
"description": "Up to eight element field comparisons, combined with AND.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"atomic_number",
"group",
"period"
],
"description": "Periodic-table integer field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"gte",
"lte"
],
"description": "Integer equality, lower bound or upper bound comparison."
},
"value": {
"type": "integer",
"minimum": 1,
"maximum": 118,
"description": "Integer to compare against the selected element field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"name",
"symbol",
"standard_state"
],
"description": "Periodic-table text field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Text to compare against the selected element field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
},
"order_by": {
"default": "atomic_number",
"description": "Element field used to order rows.",
"type": "string",
"enum": [
"atomic_number",
"name",
"symbol",
"group",
"period"
]
},
"direction": {
"default": "asc",
"description": "Ascending or descending row ordering.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"default": 20,
"description": "Maximum reference rows to return in this page, from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque next_cursor from the same dataset, filters, ordering and source snapshot.",
"type": "string",
"maxLength": 2048
}
},
"required": [
"dataset"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"dataset": {
"type": "string",
"const": "codata-constants",
"description": "Query the public CODATA constants reference dataset."
},
"filters": {
"default": [],
"description": "Up to eight CODATA field comparisons, combined with AND; cross-unit numeric comparisons are unsupported.",
"maxItems": 8,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"quantity",
"unit"
],
"description": "CODATA quantity name or source-reported unit field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"contains"
],
"description": "Exact text equality or substring containment."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Text to compare against the selected CODATA field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"column": {
"type": "string",
"enum": [
"exact",
"truncated"
],
"description": "Whether the source declares an exact value or truncates its reported digits."
},
"operator": {
"type": "string",
"const": "eq",
"description": "Boolean equality; numeric comparisons are unsupported."
},
"value": {
"type": "boolean",
"description": "Boolean value required for the selected source-status field."
}
},
"required": [
"column",
"operator",
"value"
],
"additionalProperties": false
}
]
}
},
"order_by": {
"default": "quantity",
"description": "CODATA field used to order rows.",
"type": "string",
"enum": [
"quantity",
"unit"
]
},
"direction": {
"default": "asc",
"description": "Ascending or descending row ordering.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"default": 20,
"description": "Maximum reference rows to return in this page, from 1 to 50.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque next_cursor from the same dataset, filters, ordering and source snapshot.",
"type": "string",
"maxLength": 2048
}
},
"required": [
"dataset"
],
"additionalProperties": false
}
],
"additionalProperties": false
}