Get the price of a selection: use this whenever someone asks what data would cost, the total for several products, the price with building geometry added, or the price at a licence tier for their use, instead of reading list prices from a product card. Price catalog products (items: sku from search or fetch, licence, optional building geometry) or one custom cut, such as chosen brands in chosen states (cut plus the full_cut_hash from mogean_count, and a licence). Prices are computed by the store and equal the product page; one-time prices at the internal or embedded licence only. A priced quote returns the total and can carry a quote_id that holds the price for up to 30 minutes.
View input schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "A sku from search or fetch."
},
"license": {
"type": "string",
"enum": [
"internal",
"embedded",
"redistribution"
],
"description": "Licence tier. Agents can quote internal and embedded; redistribution is handled on the Mogean store or by Mogean sales."
},
"geometry_add_on": {
"type": "boolean",
"description": "Add the building-geometry file where the product offers it; the quote prices it in."
}
},
"required": [
"sku",
"license"
],
"additionalProperties": false
},
"description": "Catalog products to price together, each with its licence tier; the result totals them (send items or cut, not both).",
"maxItems": 20
},
"cut": {
"type": "object",
"description": "A custom cut: every non-empty list narrows the selection.",
"properties": {
"brands": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Brands: ids from search (brand:<slug>) or bare slugs (fetch metadata.key).",
"maxItems": 200
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Categories: ids from search (category:<slug>) or bare slugs (fetch metadata.key).",
"maxItems": 200
},
"leaf_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Leaf categories: slugs from fetch (metadata.category.leaf_slug), or a leaf name fetch shows when it names one leaf.",
"maxItems": 200
},
"states": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "States: two-letter US codes, or ids from search (state:TX).",
"maxItems": 200
},
"gov_sources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Government sources: ids from search (gov:<slug>) or bare slugs (fetch metadata.key).",
"maxItems": 200
},
"tiers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Provenance tier groups: pipeline, government, fsq, overture. PIPELINE_AUTHORITATIVE, GOVERNMENT_AUTHORITATIVE and OVERTURE_SUPPLEMENT (as by_tier names them) select their group; the three FSQ_ tiers are selected together as fsq.",
"maxItems": 6
},
"columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"description": "Column names to deliver; empty means every column.",
"maxItems": 200
},
"format": {
"type": "string",
"enum": [
"csv_parquet",
"csv",
"parquet",
"geojson"
],
"description": "Delivery format."
},
"include_geometry": {
"type": "boolean",
"description": "Add the building-geometry file."
}
},
"additionalProperties": false
},
"full_cut_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "With cut: the full_cut_hash mogean_count returned for this exact cut."
},
"license": {
"type": "string",
"enum": [
"internal",
"embedded",
"redistribution"
],
"description": "With cut: the licence tier to price the cut at."
},
"term": {
"type": "string",
"enum": [
"one_time",
"subscription"
],
"description": "one_time (default). Agents cannot quote subscriptions."
},
"intended_use": {
"type": "object",
"description": "Optional: what the data is for. It never changes the price; where licence guidance is available the result names the licence tier that use needs.",
"properties": {
"purpose": {
"type": "string",
"enum": [
"internal_analysis",
"site_selection",
"share_within_organization",
"embed_in_product",
"display_records_to_end_users",
"resell_or_redistribute",
"ai_training",
"rag_or_embeddings",
"agent_use",
"other"
]
},
"note": {
"type": "string",
"maxLength": 200,
"description": "Free text; not stored or repeated."
}
},
"required": [
"purpose"
],
"additionalProperties": false
},
"response_format": {
"type": "string",
"enum": [
"concise",
"detailed"
],
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}