# Vibe Costs

> Vibe Costs is a cost connection and decision layer for software, infrastructure, AI, and agent spend. The Open Cost Read API is a provider-neutral proposal for customer-authorized access to live incurred cost.

## Open Cost Read API

- Human technical guide: https://vibecosts.app/cost-api/docs
- Canonical raw specification (Markdown): https://vibecosts.app/cost-api/spec
- Machine-readable OpenAPI 3.1: https://vibecosts.app/cost-api/openapi
- Response JSON Schema: https://vibecosts.app/cost-api/schema
- CI-tested positive and negative response cases: https://vibecosts.app/cost-api/conformance
- Provider overview: https://vibecosts.app/cost-api
- Security posture: https://vibecosts.app/security
- Provider contact: mailto:hello@vibecosts.app

## Implementation intent

Implement provider-hosted OAuth authorization code with PKCE and a costs:read resource scope when possible. Standard identity or renewal scopes may accompany it when required. A revocable restricted token carrying only cost-read permission is transitional. Expose consented cost accounts and current-period incurred billed cost. Money is represented as decimal strings; timestamps use the RFC 3339 UTC Z designator; open periods are estimated; credits and negative adjustments are signed. Optional effective_cost retains the FOCUS amortized-cost meaning and is not a synonym for billed_cost.

## Boundaries

Do not give Vibe Costs passwords, session cookies, payment credentials, wallet private keys, or tokens that can mutate deployments, data, members, plans, payment methods, or production resources.