{ "object": "asset_snapshot_batch", "accepted": 5, "rejected": [ { "code": "too_big", "field": "snapshots.2.power_kw", "message": "power_kw 7 is more than 1.5 times the battery's max_in_kw of 4" } ]}
Assets
Send asset snapshots
Send the live power and state of one household’s assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.
{ "object": "asset_snapshot_batch", "accepted": 5, "rejected": [ { "code": "too_big", "field": "snapshots.2.power_kw", "message": "power_kw 7 is more than 1.5 times the battery's max_in_kw of 4" } ]}
The snapshots that broke a rule and were not stored, each with the path of the field at fault. Empty when every snapshot was stored.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Nomos","colors":{"primary":"#1b1915","light":"#ffffff","dark":"#1b1915"},"logo":{"light":"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/light.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=99c5d32286bf07989f99539ad1584d34","dark":"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/dark.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=1e24faf333cc5cbbaa6454764020bc7d"},"favicon":"https://mintcdn.com/riverslate/i0UKnKz5dNnV7CMC/favicon.ico?fit=max\u0026auto=format\u0026n=i0UKnKz5dNnV7CMC\u0026q=85\u0026s=019f4931cf3d704bd7a11ab89eec374e","api":{"openapi":["openapi/openapi.chucky.json"]},"appearance":{"default":"light"},"background":{"color":{"light":"#f6f3f0","dark":"#21262c"}},"navbar":{"links":[{"href":"https://dashboard.nomos.energy","label":"Dashboard"}],"primary":{"type":"button","label":"Book Demo","href":"https://nomos.energy/demo"}},"footer":{"socials":{"website":"https://nomos.energy","linkedin":"https://www.linkedin.com/company/nomos-energy"}},"fonts":{"family":"Soehne","source":"https://qnsvr1iaztsgci9a.public.blob.vercel-storage.com/soehne-buch-d177Pah3KmnkO2UpYz4Ru0Yx4QcPU8.woff2","format":"woff2"},"contextual":{"options":["copy","view","claude","chatgpt","cursor",{"title":"Get Support","description":"Email our team about this page","icon":"life-ring","href":{"base":"mailto:support@nomos.energy","query":[{"key":"subject","value":"Docs question"},{"key":"body","value":"Page: $path\n\n"}]}}],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"riverslate","hasAudioNarration":false,"actualSubdomain":"riverslate","customDomains":["docs.nomos.energy"],"gitSource":{"type":"github","owner":"nomos-energy","repo":"monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf73dd808b7de58451f3d4","collectionId":"c9f02246-684b-4c49-811d-ebef4a05dd8a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf73dd808b7de58451f3d4"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6adf73dd808b7de58451f3d4","clientVersion":"0.0.3969","searchFilterCounts":[{"language":"default","tag":"API Reference","count":325},{"language":"default","tag":"Subscriptions","count":24},{"language":"default","tag":"Webhooks","count":23},{"language":"default","tag":"Invoices","count":20},{"language":"default","tag":"Usage","count":19},{"language":"default","tag":"Documentation","count":16},{"language":"default","tag":"Leads","count":16},{"language":"default","tag":"Plans","count":16},{"language":"default","tag":"Authentication","count":15},{"language":"default","tag":"Customers","count":12}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".light #assistant-entry,.light #search-bar-entry,.light .navbar-link a,.light button[aria-label=\"Toggle dark mode\"]{background-color:#ebe8e3!important}.light #assistant-entry:hover,.light #search-bar-entry:hover,.light .navbar-link a:hover,.light button[aria-label=\"Toggle dark mode\"]:hover{background-color:#e2ded9!important}.light #navbar>div.bg-background-light,.light #page-context-menu button,.light #pagination>a,.light .card,.light [data-component-part=version-select-content],.light [role=menu][aria-labelledby^=page-context-menu],.light details.accordion,.light details.expandable{background-color:#fdfbfa}.dark #navbar>div.bg-background-light{background-color:#000}.dark #background-color{background-color:#0a0a0a}.dark #page-context-menu button,.dark #pagination>a,.dark [role=menu][aria-labelledby^=page-context-menu]{background-color:#21262c}#page-context-menu-button span{display:none}#page-context-menu{min-width:0;align-items:stretch}body:has(.is-home-page) #page-context-menu,body:has(.is-home-page) #pagination{display:none!important}.light div.bg-background-light:has(>div>.tryit-button){background-color:#fdfbfa}td code,th code{white-space:nowrap}@font-face{font-family:\"Soehne\";src:url(/fonts/soehne-kraftig.woff2) format(\"woff2\");font-weight:500 700;font-style:normal;font-display:swap}#navbar img[alt=\"dark logo\"],#navbar img[alt=\"light logo\"],#navbar img[src*=logo]{height:1.25rem;width:auto}h1,h2,h3,h4{font-weight:500!important}#navbar nav ul li a,.nav-tabs-item{font-weight:400!important}.nav-tabs-item{text-shadow:none!important}"}],"page":{"pagePath":"api-reference-2026-09-08-gauss/assets/send-asset-snapshots","slug":"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots","pageMetadata":{"title":"Send asset snapshots","description":"Send the live power and state of one household's assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in `rejected` with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in `errors`. A body that does not match the schema is refused as a whole.","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /asset-snapshots","href":"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Send the live power and state of one household’s assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in \", _jsx(_components.code, {\n children: \"rejected\"\n }), \" with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in \", _jsx(_components.code, {\n children: \"errors\"\n }), \". A body that does not match the schema is refused as a whole.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Send asset snapshots","description":"Send the live power and state of one household's assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in `rejected` with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in `errors`. A body that does not match the schema is refused as a whole.","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /asset-snapshots","href":"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Assets"],"summary":"Send asset snapshots","description":"Send the live power and state of one household's assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in `rejected` with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in `errors`. A body that does not match the schema is refused as a whole.","security":["868745c7-25f6-4b7e-8914-8d6ad3adcc39"],"requestBody":"24125e19-eda7-4f17-ad43-f3cad9d6a21e","responses":{"200":"abb02d20-5dac-42e7-9f9b-06a3cb2fd0e5","400":"1814114f-895d-4e8e-a472-4695c0a7db87","401":"77439db5-539e-4f43-ac49-6e6f5a9ad0f7","403":"9140bd19-7f8f-4a29-a1a2-e834c08dac59","404":"bd41be45-1382-4da2-8909-2a567664ca0b","409":"3940f89f-2b44-435d-b98b-3184aabe2480","500":"35d8a089-d2f7-4303-8d5b-fc5de2d89b7b"},"method":"post","type":"path","servers":["426f6ba9-8ef9-42c6-bd41-df0ba3c9ecda"],"path":"/asset-snapshots","baseUrlOptions":["https://api.nomos.energy"],"title":"Send asset snapshots","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"snapshots":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"Our ID of the asset. All snapshots of one request belong to the same household.","example":"ha_b7q2m1k8v4n0x3c9l5p2r7td","isRequired":true,"uniqueKey":"snapshots.items.[INDEX].asset","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"When the device measured the values, ISO 8601 with an offset. It may not lie in the future.","example":"2026-10-06T10:14:50.000Z","isRequired":true,"uniqueKey":"snapshots.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"is_online":{"type":"boolean","description":"Whether the device was reachable. An offline snapshot carries no other value.","example":true,"isRequired":true,"uniqueKey":"snapshots.items.[INDEX].is_online","typeLabel":"boolean"},"power_kw":{"oneOf":[{"type":"number","description":"Power in kW, positive into the asset (charging, consumption, import) and negative out of it (discharging, production, export). Taken by every type except `inverter`: `solar` only negative, `household_residual`, `heat_pump` and `wallbox` only positive, `household_net` and `battery` both. More than 1.5 times the asset's rating is rejected: `peak_power_kwp` for `solar`, `max_in_kw` and `max_out_kw` for `battery`, `max_in_kw` for `wallbox` and `heat_pump`.","example":2,"uniqueKey":"snapshots.items.[INDEX].power_kw.oneOf.0","typeLabel":"number"},{"type":"null","description":"Power in kW, positive into the asset (charging, consumption, import) and negative out of it (discharging, production, export). Taken by every type except `inverter`: `solar` only negative, `household_residual`, `heat_pump` and `wallbox` only positive, `household_net` and `battery` both. More than 1.5 times the asset's rating is rejected: `peak_power_kwp` for `solar`, `max_in_kw` and `max_out_kw` for `battery`, `max_in_kw` for `wallbox` and `heat_pump`.","example":2,"uniqueKey":"snapshots.items.[INDEX].power_kw.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].power_kw","typeLabel":"number | null"},"soc":{"oneOf":[{"type":"number","description":"The battery's charge level as a share from 0 to 1. `battery` only, and required while a battery we steer is online.","example":0.694,"uniqueKey":"snapshots.items.[INDEX].soc.oneOf.0","typeLabel":"number"},{"type":"null","description":"The battery's charge level as a share from 0 to 1. `battery` only, and required while a battery we steer is online.","example":0.694,"uniqueKey":"snapshots.items.[INDEX].soc.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].soc","typeLabel":"number | null"},"is_car_connected":{"oneOf":[{"type":"boolean","description":"Whether a car is plugged in. `wallbox` only. A snapshot with `power_kw` above 0 while this is `false` is rejected.","example":null,"uniqueKey":"snapshots.items.[INDEX].is_car_connected.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether a car is plugged in. `wallbox` only. A snapshot with `power_kw` above 0 while this is `false` is rejected.","example":null,"uniqueKey":"snapshots.items.[INDEX].is_car_connected.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].is_car_connected","typeLabel":"boolean | null"},"controlled_by":{"oneOf":[{"type":"string","enum":["schedule","local","customer","grid_operator","protection","unknown",null],"description":"Who controls the device right now: our schedule, the device's own logic, the customer, the grid operator, a protection function, or unknown. `battery`, `wallbox`, `heat_pump` and `inverter`.","example":"schedule","uniqueKey":"snapshots.items.[INDEX].controlled_by.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["schedule","local","customer","grid_operator","protection","unknown",null],"description":"Who controls the device right now: our schedule, the device's own logic, the customer, the grid operator, a protection function, or unknown. `battery`, `wallbox`, `heat_pump` and `inverter`.","example":"schedule","uniqueKey":"snapshots.items.[INDEX].controlled_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].controlled_by","typeLabel":"enum\u003cstring> | null"},"curtailment":{"oneOf":[{"type":"string","enum":["active","inactive","unknown",null],"description":"Whether the inverter curtails solar right now. `inverter` only.","example":null,"uniqueKey":"snapshots.items.[INDEX].curtailment.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["active","inactive","unknown",null],"description":"Whether the inverter curtails solar right now. `inverter` only.","example":null,"uniqueKey":"snapshots.items.[INDEX].curtailment.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].curtailment","typeLabel":"enum\u003cstring> | null"},"max_out_kw":{"oneOf":[{"type":"number","description":"The inverter's output cap in force, in kW. `inverter` only.","example":null,"uniqueKey":"snapshots.items.[INDEX].max_out_kw.oneOf.0","typeLabel":"number"},{"type":"null","description":"The inverter's output cap in force, in kW. `inverter` only.","example":null,"uniqueKey":"snapshots.items.[INDEX].max_out_kw.oneOf.1","typeLabel":"null"}],"uniqueKey":"snapshots.items.[INDEX].max_out_kw","typeLabel":"number | null"}},"required":["asset","timestamp","is_online"],"additionalProperties":false,"description":"Each asset type takes only some of the value fields, and a snapshot carrying another one is rejected with `field_not_allowed`. `household_net`: `power_kw`. `household_residual`: `power_kw`. `inverter`: `controlled_by`, `curtailment`, `max_out_kw`. `solar`: `power_kw`. `battery`: `power_kw`, `soc`, `controlled_by`. `wallbox`: `power_kw`, `is_car_connected`, `controlled_by`. `heat_pump`: `power_kw`, `controlled_by`. An `inverter` takes no `power_kw`: send the power on the `solar` and `battery` assets behind it.","uniqueKey":"snapshots.items.[INDEX]","typeLabel":"object"},"minItems":1,"maxItems":10000,"description":"1 to 10,000 snapshots of one household's assets.","isRequired":true,"uniqueKey":"snapshots","typeLabel":"object[]"}},"required":["snapshots"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"snapshots":[{"asset":"ha_b7q2m1k8v4n0x3c9l5p2r7td","timestamp":"2026-10-06T10:14:50.000Z","is_online":true,"power_kw":2,"soc":0.694,"is_car_connected":null,"controlled_by":"schedule","curtailment":null,"max_out_kw":null}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"abb02d20-5dac-42e7-9f9b-06a3cb2fd0e5":{"description":"The valid snapshots were stored, the rest are listed in `rejected`","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["asset_snapshot_batch"],"isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"accepted":{"type":"integer","description":"How many snapshots were stored.","example":5,"isRequired":true,"uniqueKey":"accepted","typeLabel":"integer"},"rejected":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"too_big","isRequired":true,"uniqueKey":"rejected.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"snapshots.2.power_kw","isRequired":true,"uniqueKey":"rejected.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"power_kw 7 is more than 1.5 times the battery's max_in_kw of 4","isRequired":true,"uniqueKey":"rejected.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"rejected.items.[INDEX]","typeLabel":"object"},"description":"The snapshots that broke a rule and were not stored, each with the path of the field at fault. Empty when every snapshot was stored.","isRequired":true,"uniqueKey":"rejected","typeLabel":"object[]"}},"required":["object","accepted","rejected"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"asset_snapshot_batch","accepted":5,"rejected":[{"code":"too_big","field":"snapshots.2.power_kw","message":"power_kw 7 is more than 1.5 times the battery's max_in_kw of 4"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"1814114f-895d-4e8e-a472-4695c0a7db87":{"description":"The request is invalid: a field fails validation, breaks a business rule, or the body is not valid JSON. `errors` lists every problem with its field.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST"],"description":"The error code related to the status code.","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"What is wrong with the field, such as `invalid_type` or `asset_not_found`. `x-extensible-enum` lists the values known today. New values can be added in any API version, so treat an unknown value like any other error of the response's status.","example":"invalid_type","x-extensible-enum":["invalid_type","too_big","too_small","invalid_format","not_multiple_of","unrecognized_keys","invalid_union","invalid_key","invalid_element","invalid_value","custom","unserviceable_zip","ended_subscription","duplicate_grid_reduction","missing_smart_meter","missing_module_1","incompatible_grid_reduction","unsupported_product","unsupported_meter_order","duplicate_meter_order","unsupported_meter","out_of_period_meter_reading","unsupported_meter_reading","duplicate_meter_reading","implausible_meter_reading","duplicate_customer_email","invalid_iban","upgrade_api_version","withdrawal_not_allowed","invalid_termination_date","subscription_not_started","terminated_subscription","missing_household","invalid_household_customer","invalid_household_meter","duplicate_consumption_subscription","invalid_inverter","read_only_asset","duplicate_external_id","asset_has_children","asset_decommissioned","asset_not_found","mixed_households","field_not_allowed","invalid_direction","duplicate_timestamp","asset_not_steerable","mode_not_allowed","slot_missing"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"customer.email","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"Invalid input: expected string, received undefined","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field breakdown of a validation or business-rule failure. Omitted for API versions before the structured-errors cutoff.","uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Missing required field":{"title":"Missing required field","value":{"code":"BAD_REQUEST","message":"Invalid input: expected boolean, received undefined","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","errors":[{"code":"invalid_type","field":"snapshots.0.is_online","message":"Invalid input: expected boolean, received undefined"}]}},"Unknown field in a snapshot":{"title":"Unknown field in a snapshot","value":{"code":"BAD_REQUEST","message":"Unrecognized key: \"state_of_charge\"","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","errors":[{"code":"unrecognized_keys","field":"snapshots.0","message":"Unrecognized key: \"state_of_charge\""}]}},"Field the asset type does not take":{"title":"Field the asset type does not take","value":{"code":"BAD_REQUEST","message":"an inverter snapshot has no power_kw","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST","errors":[{"code":"field_not_allowed","field":"snapshots.0.power_kw","message":"an inverter snapshot has no power_kw"}]}},"Body is not valid JSON":{"title":"Body is not valid JSON","value":{"code":"BAD_REQUEST","message":"Malformed JSON in request body","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST"}},"Unsupported version header":{"title":"Unsupported version header","value":{"code":"BAD_REQUEST","message":"Version header 2026-01-01.foo is invalid.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/BAD_REQUEST"}}},"exampleType":"examples"}},"exampleType":"examples"},"77439db5-539e-4f43-ac49-6e6f5a9ad0f7":{"description":"The access token is missing, expired or invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["UNAUTHORIZED"],"description":"The error code related to the status code.","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"No token":{"title":"No token","value":{"code":"UNAUTHORIZED","message":"No authorization header provided.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}},"Expired token":{"title":"Expired token","value":{"code":"UNAUTHORIZED","message":"Token expired","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}},"Invalid token":{"title":"Invalid token","value":{"code":"UNAUTHORIZED","message":"Invalid or malformed token","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/UNAUTHORIZED"}}},"exampleType":"examples"}},"exampleType":"examples"},"9140bd19-7f8f-4a29-a1a2-e834c08dac59":{"description":"The access token is valid but not allowed to use this endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["FORBIDDEN"],"description":"The error code related to the status code.","example":"FORBIDDEN","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/FORBIDDEN","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Role without access":{"title":"Role without access","value":{"code":"FORBIDDEN","message":"Forbidden to access this route.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/FORBIDDEN"}},"Token without scope":{"title":"Token without scope","value":{"code":"FORBIDDEN","message":"Insufficient scope: write:* required.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/FORBIDDEN"}},"Customer token without customer":{"title":"Customer token without customer","value":{"code":"FORBIDDEN","message":"Customer not found.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/FORBIDDEN"}}},"exampleType":"examples"}},"exampleType":"examples"},"bd41be45-1382-4da2-8909-2a567664ca0b":{"description":"A resource in the path or the body does not exist or belongs to another organization, or the endpoint does not exist in the API version of your token.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["NOT_FOUND"],"description":"The error code related to the status code.","example":"NOT_FOUND","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/NOT_FOUND","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"What is wrong with the field, such as `invalid_type` or `asset_not_found`. `x-extensible-enum` lists the values known today. New values can be added in any API version, so treat an unknown value like any other error of the response's status.","example":"invalid_type","x-extensible-enum":["invalid_type","too_big","too_small","invalid_format","not_multiple_of","unrecognized_keys","invalid_union","invalid_key","invalid_element","invalid_value","custom","unserviceable_zip","ended_subscription","duplicate_grid_reduction","missing_smart_meter","missing_module_1","incompatible_grid_reduction","unsupported_product","unsupported_meter_order","duplicate_meter_order","unsupported_meter","out_of_period_meter_reading","unsupported_meter_reading","duplicate_meter_reading","implausible_meter_reading","duplicate_customer_email","invalid_iban","upgrade_api_version","withdrawal_not_allowed","invalid_termination_date","subscription_not_started","terminated_subscription","missing_household","invalid_household_customer","invalid_household_meter","duplicate_consumption_subscription","invalid_inverter","read_only_asset","duplicate_external_id","asset_has_children","asset_decommissioned","asset_not_found","mixed_households","field_not_allowed","invalid_direction","duplicate_timestamp","asset_not_steerable","mode_not_allowed","slot_missing"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"customer.email","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"Invalid input: expected string, received undefined","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field breakdown of a validation or business-rule failure. Omitted for API versions before the structured-errors cutoff.","uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Unknown asset":{"title":"Unknown asset","value":{"code":"NOT_FOUND","message":"Asset ha_b7q2m1k8v4n0x3c9l5p2r7td not found.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/NOT_FOUND","errors":[{"code":"asset_not_found","field":"snapshots.0.asset","message":"Asset ha_b7q2m1k8v4n0x3c9l5p2r7td not found."}]}},"Endpoint not in your API version":{"title":"Endpoint not in your API version","value":{"code":"NOT_FOUND","message":"There is no POST /asset-snapshots in API version 2025-12-01.chucky.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/NOT_FOUND"}}},"exampleType":"examples"}},"exampleType":"examples"},"3940f89f-2b44-435d-b98b-3184aabe2480":{"description":"The request conflicts with the current state of a resource, for example a duplicate or a resource that has ended.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["CONFLICT"],"description":"The error code related to the status code.","example":"CONFLICT","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/CONFLICT","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"What is wrong with the field, such as `invalid_type` or `asset_not_found`. `x-extensible-enum` lists the values known today. New values can be added in any API version, so treat an unknown value like any other error of the response's status.","example":"invalid_type","x-extensible-enum":["invalid_type","too_big","too_small","invalid_format","not_multiple_of","unrecognized_keys","invalid_union","invalid_key","invalid_element","invalid_value","custom","unserviceable_zip","ended_subscription","duplicate_grid_reduction","missing_smart_meter","missing_module_1","incompatible_grid_reduction","unsupported_product","unsupported_meter_order","duplicate_meter_order","unsupported_meter","out_of_period_meter_reading","unsupported_meter_reading","duplicate_meter_reading","implausible_meter_reading","duplicate_customer_email","invalid_iban","upgrade_api_version","withdrawal_not_allowed","invalid_termination_date","subscription_not_started","terminated_subscription","missing_household","invalid_household_customer","invalid_household_meter","duplicate_consumption_subscription","invalid_inverter","read_only_asset","duplicate_external_id","asset_has_children","asset_decommissioned","asset_not_found","mixed_households","field_not_allowed","invalid_direction","duplicate_timestamp","asset_not_steerable","mode_not_allowed","slot_missing"],"isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"field":{"type":"string","example":"customer.email","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","example":"Invalid input: expected string, received undefined","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["code","field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field breakdown of a validation or business-rule failure. Omitted for API versions before the structured-errors cutoff.","uniqueKey":"errors","typeLabel":"object[]"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Asset decommissioned before the snapshot":{"title":"Asset decommissioned before the snapshot","value":{"code":"CONFLICT","message":"Asset ha_b7q2m1k8v4n0x3c9l5p2r7td was decommissioned before 2026-10-06T10:14:50.000Z.","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/CONFLICT","errors":[{"code":"asset_decommissioned","field":"snapshots.0.timestamp","message":"Asset ha_b7q2m1k8v4n0x3c9l5p2r7td was decommissioned before 2026-10-06T10:14:50.000Z."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"35d8a089-d2f7-4303-8d5b-fc5de2d89b7b":{"description":"Something went wrong on our side. Retry later, and send us the `requestId` if it persists.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","enum":["INTERNAL_SERVER_ERROR"],"description":"The error code related to the status code.","example":"INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A human readable message describing the issue.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"The request id to be used for debugging and error reporting.","example":"37a04f8f-e791-491c-81e1-86cd304649bb","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"docs":{"type":"string","description":"The docs related to the error code.","example":"https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"docs","typeLabel":"string"}},"required":["code","message","requestId","docs"],"uniqueKey":"","typeLabel":"object"},"examples":{"Unexpected error":{"title":"Unexpected error","value":{"code":"INTERNAL_SERVER_ERROR","message":"Internal Server Error","requestId":"37a04f8f-e791-491c-81e1-86cd304649bb","docs":"https://docs.nomos.energy/api-references/errors/INTERNAL_SERVER_ERROR"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"868745c7-25f6-4b7e-8914-8d6ad3adcc39":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"}}},"servers":{"426f6ba9-8ef9-42c6-bd41-df0ba3c9ecda":{"url":"https://api.nomos.energy","description":"production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"openapi/openapi.gauss.json"},"subdomain":"riverslate","siteName":"Nomos","title":"Send asset snapshots - Nomos","navMaps":{"firstHrefInVersion":{"2026-09-08.gauss (preview)":{"href":"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots","matchLevel":0},"2026-05-27.curie":{"href":"/api-reference/plans/list-plans","matchLevel":2},"2026-01-29.edison":{"href":"/api-reference-2026-01-29-edison/plans/list-plans","matchLevel":2},"2025-12-16.batman":{"href":"/api-reference-2025-12-16-batman/plans/list-plans","matchLevel":2},"2025-12-01.chucky":{"href":"/api-reference-2025-12-01-chucky/plans/retrieve-a-plan","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T15:38:21.043Z","originalFileLocation":"api-reference-2026-09-08-gauss/assets/send-asset-snapshots.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send the live power and state of one household\u0026#x27;s assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nomos\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send asset snapshots - Nomos\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send the live power and state of one household\u0026#x27;s assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nomos\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://riverslate.mintlify.app/_mintlify/api/og/v2?division=Assets\u0026amp;title=Send+asset+snapshots\u0026amp;description=Send+the+live+power+and+state+of+one+household%27s+assets%2C+up+to+10%2C000+snapshots+per+request.+Every+valid+snapshot+is+stored%2C+and+a+snapshot+that+breaks+a+rule+i\u0026amp;theme=5668da0c231285124c856495\u0026amp;signature=8654f6ad79f85bca9c68a0e33d4b2a695e77c17735bc443c9bda7280115aa45f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Send asset snapshots - Nomos\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send the live power and state of one household\u0026#x27;s assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://riverslate.mintlify.app/_mintlify/api/og/v2?division=Assets\u0026amp;title=Send+asset+snapshots\u0026amp;description=Send+the+live+power+and+state+of+one+household%27s+assets%2C+up+to+10%2C000+snapshots+per+request.+Every+valid+snapshot+is+stored%2C+and+a+snapshot+that+breaks+a+rule+i\u0026amp;theme=5668da0c231285124c856495\u0026amp;signature=8654f6ad79f85bca9c68a0e33d4b2a695e77c17735bc443c9bda7280115aa45f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/riverslate/iILQM7kXCjcV9kRT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nomos\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1b1915\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nomos.energy/#organization\",\"name\":\"Nomos\",\"url\":\"https://docs.nomos.energy\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/riverslate/0nQqndf6SGR4MtUC/logo/light.svg?fit=max\u0026auto=format\u0026n=0nQqndf6SGR4MtUC\u0026q=85\u0026s=99c5d32286bf07989f99539ad1584d34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nomos.energy#website\",\"name\":\"Nomos\",\"url\":\"https://docs.nomos.energy\",\"publisher\":{\"@id\":\"https://docs.nomos.energy/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots#webpage\",\"url\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots\",\"name\":\"Send asset snapshots\",\"description\":\"Send the live power and state of one household's assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.\",\"dateModified\":\"2026-10-26T15:38:21.043Z\",\"isPartOf\":{\"@id\":\"https://docs.nomos.energy#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/plans/calculate-a-quote\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Assets\",\"item\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/list-assets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Send asset snapshots\",\"item\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots#apireference\",\"headline\":\"Send asset snapshots\",\"name\":\"Send asset snapshots\",\"description\":\"Send the live power and state of one household's assets, up to 10,000 snapshots per request. Every valid snapshot is stored, and a snapshot that breaks a rule is left out and listed in rejected with the path of the field at fault. When no snapshot is valid, the request answers with an error listing every problem in errors. A body that does not match the schema is refused as a whole.\",\"url\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nomos.energy/api-reference-2026-09-08-gauss/assets/send-asset-snapshots#webpage\"},\"dateModified\":\"2026-10-26T15:38:21.043Z\",\"publisher\":{\"@id\":\"https://docs.nomos.energy/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nomos.energy#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nomos\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nomos","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/home"}]},{"tab":"API Reference","icon":"code","versions":[{"version":"2026-09-08.gauss (preview)","groups":[{"group":" ","pages":[{"title":"API Reference","sidebarTitle":"Introduction","href":"/api-references/introduction"},{"title":"Authentication","href":"/api-references/authentication"},{"title":"Versioning","href":"/api-references/versioning"},{"title":"Pagination","href":"/api-references/pagination"},{"title":"Filtering","href":"/api-references/filtering"},{"title":"Errors","href":"/api-references/errors"},{"title":"Changelog","href":"/api-references/changelog"}]},{"group":"API Reference","pages":[{"group":"Plans","pages":[{"title":"Calculate a quote","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /plans/{id}/quote","href":"/api-reference-2026-09-08-gauss/plans/calculate-a-quote"},{"title":"Calculate savings","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /plans/{id}/savings","href":"/api-reference-2026-09-08-gauss/plans/calculate-savings"},{"title":"List plans","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /plans","href":"/api-reference-2026-09-08-gauss/plans/list-plans"},{"title":"Retrieve a plan","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /plans/{id}","href":"/api-reference-2026-09-08-gauss/plans/retrieve-a-plan"}]},{"group":"Leads","pages":[{"title":"Retrieve a lead","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /leads/{id}","href":"/api-reference-2026-09-08-gauss/leads/retrieve-a-lead"},{"title":"Update a lead","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json patch /leads/{id}","href":"/api-reference-2026-09-08-gauss/leads/update-a-lead"},{"title":"List leads","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /leads","href":"/api-reference-2026-09-08-gauss/leads/list-leads"},{"title":"Create a lead","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /leads","href":"/api-reference-2026-09-08-gauss/leads/create-a-lead"}]},{"group":"Subscriptions","pages":[{"title":"Retrieve a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /subscriptions/{id}","href":"/api-reference-2026-09-08-gauss/subscriptions/retrieve-a-subscription"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json patch /subscriptions/{id}","href":"/api-reference-2026-09-08-gauss/subscriptions/update-a-subscription"},{"title":"Terminate a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /subscriptions/{id}/terminate","href":"/api-reference-2026-09-08-gauss/subscriptions/terminate-a-subscription"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /subscriptions","href":"/api-reference-2026-09-08-gauss/subscriptions/list-subscriptions"},{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /subscriptions","href":"/api-reference-2026-09-08-gauss/subscriptions/create-a-subscription"}]},{"group":"Customers","pages":[{"title":"Retrieve a customer","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /customers/{id}","href":"/api-reference-2026-09-08-gauss/customers/retrieve-a-customer"},{"title":"Update a customer","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json patch /customers/{id}","href":"/api-reference-2026-09-08-gauss/customers/update-a-customer"},{"title":"List customers","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /customers","href":"/api-reference-2026-09-08-gauss/customers/list-customers"}]},{"group":"Households","pages":[{"title":"List households","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /households","href":"/api-reference-2026-09-08-gauss/households/list-households"},{"title":"Retrieve a household","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /households/{id}","href":"/api-reference-2026-09-08-gauss/households/retrieve-a-household"}]},{"group":"Assets","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /assets","href":"/api-reference-2026-09-08-gauss/assets/list-assets"},{"title":"Add an asset","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /assets","href":"/api-reference-2026-09-08-gauss/assets/add-an-asset"},{"title":"Retrieve an asset","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /assets/{id}","href":"/api-reference-2026-09-08-gauss/assets/retrieve-an-asset"},{"title":"Update an asset","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json patch /assets/{id}","href":"/api-reference-2026-09-08-gauss/assets/update-an-asset"},{"title":"Decommission an asset","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /assets/{id}/decommission","href":"/api-reference-2026-09-08-gauss/assets/decommission-an-asset"},{"title":"List the newest asset snapshots","description":"The newest snapshot of each asset of the households or assets you filter by, from the last 24 hours. A household or asset filter is required.","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /asset-snapshots","href":"/api-reference-2026-09-08-gauss/assets/list-the-newest-asset-snapshots"},{"title":"Send asset snapshots","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /asset-snapshots","href":"/api-reference-2026-09-08-gauss/assets/send-asset-snapshots"},{"title":"Retrieve an asset schedule","description":"The plan in force for an asset over Berlin delivery dates: one slot per planned quarter hour. A quarter hour without a slot runs the device's own logic.","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /assets/{id}/schedule","href":"/api-reference-2026-09-08-gauss/assets/retrieve-an-asset-schedule"}]},{"group":"Usage","pages":[{"title":"Retrieve usage data","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /subscriptions/{id}/usage","href":"/api-reference-2026-09-08-gauss/usage/retrieve-usage-data"},{"title":"List meter readings","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /meter-readings","href":"/api-reference-2026-09-08-gauss/usage/list-meter-readings"},{"title":"Create a meter reading","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /meter-readings","href":"/api-reference-2026-09-08-gauss/usage/create-a-meter-reading"}]},{"group":"Prices","pages":[{"title":"Retrieve spot prices","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /spot-prices","href":"/api-reference-2026-09-08-gauss/prices/retrieve-spot-prices"},{"title":"Retrieve a subscription price time series","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /subscriptions/{id}/prices","href":"/api-reference-2026-09-08-gauss/prices/retrieve-a-subscription-price-time-series"}]},{"group":"Invoices","pages":[{"title":"Retrieve an invoice","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /invoices/{id}","href":"/api-reference-2026-09-08-gauss/invoices/retrieve-an-invoice"},{"title":"List invoices","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /invoices","href":"/api-reference-2026-09-08-gauss/invoices/list-invoices"},{"title":"Retrieve an invoice PDF","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /invoices/{id}/file","href":"/api-reference-2026-09-08-gauss/invoices/retrieve-an-invoice-pdf"}]},{"group":"Smart Meter Orders","pages":[{"title":"Retrieve a smart meter order","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /meter-orders/{id}","href":"/api-reference-2026-09-08-gauss/smart-meter-orders/retrieve-a-smart-meter-order"},{"title":"List smart meter orders","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /meter-orders","href":"/api-reference-2026-09-08-gauss/smart-meter-orders/list-smart-meter-orders"},{"title":"Create a smart meter order","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /meter-orders","href":"/api-reference-2026-09-08-gauss/smart-meter-orders/create-a-smart-meter-order"}]},{"group":"Grid Fee Reductions","pages":[{"title":"List grid fee reductions","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /grid-fee-reductions","href":"/api-reference-2026-09-08-gauss/grid-fee-reductions/list-grid-fee-reductions"},{"title":"Create a grid fee reduction","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /grid-fee-reductions","href":"/api-reference-2026-09-08-gauss/grid-fee-reductions/create-a-grid-fee-reduction"},{"title":"Retrieve a grid fee reduction","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /grid-fee-reductions/{id}","href":"/api-reference-2026-09-08-gauss/grid-fee-reductions/retrieve-a-grid-fee-reduction"}]},{"group":"Market Partners","pages":[{"title":"List market partners","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /market-partners","href":"/api-reference-2026-09-08-gauss/market-partners/list-market-partners"}]},{"group":"Events","pages":[{"title":"Retrieve an event","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /events/{id}","href":"/api-reference-2026-09-08-gauss/events/retrieve-an-event"}]},{"group":"Authentication","pages":[{"title":"Create a token","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /oauth/token","href":"/api-reference-2026-09-08-gauss/authentication/create-a-token"},{"title":"Authorize","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json get /oauth/authorize","href":"/api-reference-2026-09-08-gauss/authentication/authorize"},{"title":"Create a magic link (customer portal)","deprecated":null,"version":null,"openapi":"/openapi/openapi.gauss.json post /admin/magic_link","href":"/api-reference-2026-09-08-gauss/authentication/create-a-magic-link-customer-portal"}]}]}]},{"version":"2026-05-27.curie","default":true,"pages":[{"title":"2026-05-27.curie","href":"/api-reference/plans/list-plans"}]},{"version":"2026-01-29.edison","pages":[{"title":"2026-01-29.edison","href":"/api-reference-2026-01-29-edison/plans/list-plans"}]},{"version":"2025-12-16.batman","pages":[{"title":"2025-12-16.batman","href":"/api-reference-2025-12-16-batman/plans/list-plans"}]},{"version":"2025-12-01.chucky","pages":[{"title":"2025-12-01.chucky","href":"/api-reference-2025-12-01-chucky/plans/retrieve-a-plan"}]}]},{"tab":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/webhooks/introduction"}]}]},"title":"Send asset snapshots - Nomos","buildId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","deploymentId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-S3ptrr-V.js","utils-CUxEJy9u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DavhVrxy.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1sOUY6E.js","snippetPresets-C-RLYOrF.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Duz18EdI.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DPsbCc6D.js","shallow-B1dlhlOw.js","getApiPlaygroundDisplay-DvOu-BhE.js","CodeSnippet-By8wd64X.js","CodeSnippets-BxVv6TjI.js","Page-BGh0lBck.js","getPastedJson-DOAt9xJn.js","icon-BYg-qtQ2.js","MethodPill-Dtah8ZSz.js","DuplicateIcon-guWfDmh1.js","createIcon-pTGhj_hk.js","DynamicMarkdown-DpsHMHVL.js","SectionHeading-BbutQCjq.js","axios-vUo_bRtp.js","Markdown-DZ-stgDu.js","clsx-Dfme4k4V.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CPNs0ebX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-3JVAA-i3.js"]}