{"uid":"cap_d0miAqF_NS65mvKBFxyA8","slug":"brainiac-solar-battery-warranty-threshold-check-858aef5f","name":"BRAINIAC Solar Battery Warranty Threshold Check","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/solar-battery/warranty-threshold-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"assets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"capacityKw":{"type":"number","maximum":1000000,"minimum":0},"capacityKwh":{"type":"number","maximum":1000000000,"minimum":0},"installedAt":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":200},"panels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"measuredAt":{"type":"string","maxLength":40},"measuredKw":{"type":"number","maximum":1000000,"minimum":0},"installedAt":{"type":"string","maxLength":40},"nameplateKw":{"type":"number","maximum":1000000,"minimum":0},"priorMeasuredAt":{"type":"string","maxLength":40},"priorMeasuredKw":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":500},"faultMap":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":160},"category":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":500},"generation":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"kwh":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"irradiance":{"type":"number","maximum":1000000,"minimum":0},"expectedKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"warranties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"maxCycles":{"type":"number","maximum":1000000000,"minimum":0},"minSohPct":{"type":"number","maximum":100,"minimum":0},"installedAt":{"type":"string","maxLength":40},"maxCalendarYears":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":200},"consumption":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"loadKwh":{"type":"number","maximum":1000000000,"minimum":0},"generationKwh":{"type":"number","maximum":1000000000,"minimum":0},"gridExportKwh":{"type":"number","maximum":1000000000,"minimum":0},"gridImportKwh":{"type":"number","maximum":1000000000,"minimum":0},"batteryChargeKwh":{"type":"number","maximum":1000000000,"minimum":0},"batteryDischargeKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"batteryCycles":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"throughputKwh":{"type":"number","maximum":1000000000,"minimum":0},"depthOfDischargePct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":1000},"batteryHealth":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"sohPct":{"type":"number","maximum":100,"minimum":0},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"measuredAt":{"type":"string","maxLength":40},"measuredKwh":{"type":"number","maximum":1000000000,"minimum":0},"ratedCycles":{"type":"number","maximum":1000000000,"minimum":0},"nameplateKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"inverterEvents":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"severity":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":1000},"efficiencyPeriods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"chargeKwh":{"type":"number","maximum":1000000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"periodStart":{"type":"string","maxLength":40},"dischargeKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"type":"json","example":{"items":[{"id":"W1","kind":"capacity","source":"Caller-supplied warranty extract","assetId":"SITE-A","ageYears":4.8405,"maxCycles":6000,"minSohPct":70,"cycleCount":520,"measuredSohPct":90,"ageYearsSupplied":true,"maxCalendarYears":10,"cloudPlatformUsed":false,"maxCyclesSupplied":true,"minSohPctSupplied":true,"cycleCountSupplied":true,"sohWithinThreshold":true,"cyclesWithinThreshold":true,"measuredSohPctSupplied":true,"calendarWithinThreshold":true,"maxCalendarYearsSupplied":true,"sohWithinThresholdSupplied":true,"warrantyCoverageDetermined":false,"cyclesWithinThresholdSupplied":true,"calendarWithinThresholdSupplied":true}],"status":"checked","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Generation, panel, inverter, battery, warranty, efficiency, consumption, and asset records are copied only from labeled fields supplied by the caller.","No inverter cloud platform or paid energy monitoring service is used and no API key is required.","Degradation, SOH, efficiency, and deviation metrics use only supplied measurements. Missing values are not invented.","Inverter fault labels come from caller-supplied fault maps or simple keyword signals in supplied messages. Manufacturer cloud catalogs are not queried.","Warranty comparisons use only caller-supplied warranty thresholds and measured values. Legal warranty coverage is not determined."],"warrantyCount":1,"apiKeyRequired":false,"paidProviderUsed":false,"cloudPlatformUsed":false,"warrantyCoverageDetermined":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Kcj9eAhv8rYmK_2nF2cl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks solar battery assets against caller-supplied warranty thresholds (SOH, cycle count, calendar age) and returns per-asset compliance status without querying any external cloud platform.","exampleAgentPrompt":"Check whether my solar battery at SITE-A is still within its warranty thresholds — it has a nameplate of 100 kWh, was installed 4.8 years ago, has completed 520 cycles (max 6000), and its current state of health is 90% against a 70% minimum SOH warranty floor with a 10-year calendar limit.","exampleUseCases":[{"title":"Fleet warranty compliance audit","prompt":"I have 50 solar battery sites and need to know which ones have breached their warranty thresholds — I'll give you the asset list with installation dates, measured SOH percentages, cycle counts, and the warranty terms (min SOH 75%, max 3000 cycles, max 12 years). Tell me which assets are out of compliance."},{"title":"Single-site pre-sale warranty check","prompt":"Before I sell this solar installation, can you verify the battery is still within warranty? It was installed 6.2 years ago, has 1,800 cycles on it, the warranty allows up to 4000 cycles and 15 years, and the last measured SOH was 82% against an 80% minimum."},{"title":"Automated monthly warranty monitoring","prompt":"Every month I want to check our battery storage assets against their warranty thresholds. Here's this month's SOH readings, cycle counts, and asset records in JSON — flag any that are within 10% of breaching their minimum SOH of 70% or approaching their 5000-cycle limit."}],"resultDescription":"A JSON object containing an `items` array with per-battery warranty check results including: age in years, cycle count vs maximum, measured SOH vs minimum threshold, boolean flags for each threshold dimension (SOH, cycles, calendar age), which values were caller-supplied vs inferred, an overall `status` field, any `findings` flagging issues, a `checkedAt` timestamp, and `limitations` disclaimers clarifying that no external cloud platform or manufacturer API was queried and that warranty legal coverage is not determined.","failureModes":["Missing required threshold fields (minSohPct, maxCycles, maxCalendarYears) result in threshold flags marked as not supplied rather than computed","Incomplete asset records (no installedAt date) prevent calendar age calculation","SOH or cycle count not supplied means those dimensions cannot be evaluated","Malformed date strings in installedAt or measuredAt may cause age calculation errors","Exceeding maxItems (200 assets, 500 panels) causes request rejection","Payload size exceeding maxLength limits causes rejection"],"whenToPreferThis":"Use this endpoint when you have caller-supplied warranty terms and battery measurements and need a structured, auditable compliance check without relying on any manufacturer cloud API or inverter monitoring platform. Ideal for agents that have already gathered raw asset data and warranty documents and need to programmatically determine threshold compliance at $0.03 per call with no account setup. Prefer over manual analysis when processing multiple assets or when you need explicit boolean flags per warranty dimension for downstream automation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:57.160Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-warranty-threshold-check-858aef5f"}