# Cloud FinOps API

> Parse brainiac-billing-v1 charges, score daily cost anomalies, allocate spend, and forecast from the supplied export. No cloud account is connected.

- Product: https://www.brainiac.software/api/cloud-finops
- Docs: https://www.brainiac.software/api/cloud-finops/docs
- OpenAPI: https://www.brainiac.software/api/cloud-finops/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

- POST /api/v1/cloud-finops/billing-csv-parse — $0.03 USDC — Parse a billing CSV: Read brainiac-billing-v1 CSV or JSON charges. Required columns are date, service, cost, and currency. Native cloud-provider exports are rejected. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-billing-csv-parse
- POST /api/v1/cloud-finops/cost-anomaly-detect — $0.04 USDC — Detect cost anomalies: Score daily totals with a sample z-score. A day is flagged when the absolute z-score is at least 3 and at least 8 days were supplied. Fewer days are not scored. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-cost-anomaly-detect
- POST /api/v1/cloud-finops/spend-breakdown — $0.03 USDC — Break down cloud spend: Sum supplied charges by service, region, account, or a tag. When groupBy is omitted, charges are grouped by service. Currencies are not converted. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-spend-breakdown
- POST /api/v1/cloud-finops/idle-resource-detect — $0.04 USDC — Detect idle compute: Mark compute idle only when daysObserved meets the supplied minimum and cpuPercent is below the supplied threshold. Missing CPU is not treated as idle. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-idle-resource-detect
- POST /api/v1/cloud-finops/unused-storage-detect — $0.04 USDC — Detect unused storage: Mark a volume unused only when the supplied days meet minimumDays and the volume is unattached or usedGb is 0. Attachment alone is not usage. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-unused-storage-detect
- POST /api/v1/cloud-finops/compute-cost-compare — $0.03 USDC — Compare supplied compute prices: Multiply each supplied hourly price by the supplied hours. Options in different currencies are not converted, and no provider list price is added. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-compute-cost-compare
- POST /api/v1/cloud-finops/monthly-cost-forecast — $0.05 USDC — Forecast monthly cloud cost: Fit a line through at least three supplied monthly totals, or multiply the average daily cost by the length of the next month when at least 14 days are supplied. Less history is not forecast. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-monthly-cost-forecast
- POST /api/v1/cloud-finops/budget-variance-analyze — $0.03 USDC — Analyze budget variance: Subtract the supplied budget from the supplied charges inside the period. Missing days stay uncovered and are not filled with zero from another currency. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-budget-variance-analyze
- POST /api/v1/cloud-finops/cost-allocation — $0.04 USDC — Allocate cloud cost by tag: Group supplied charges by one tag key. Charges without that tag remain unallocated. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-cost-allocation
- POST /api/v1/cloud-finops/cost-optimization-report — $0.12 USDC — Report cloud cost evidence: Combine the supplied billing, usage, price, and budget checks. Recommendations repeat the evidence and the assumption. No account is connected and no resource is changed. Docs: https://www.brainiac.software/api/cloud-finops/docs#cloud-finops-cost-optimization-report