API Overview - CostHawk Documentation

Base URL

https://costhawk.ai/api

All API requests require an access token in the Authorization header:

Authorization: Bearer ch_sk_your_token_here

Get your token from Settings → Developer in your CostHawk dashboard.

All responses are JSON:

{
  "data": { ... },
  "error": null
}

Error responses:

{
  "data": null,
  "error": "Error message here"
}

Rate limit headers are included in every response:

Method	Endpoint	Description
GET	`/mcp/usage/summary`	Get usage summary
GET	`/mcp/usage/by-tag`	Get usage by tag

Method	Endpoint	Description
GET	`/mcp/anomalies`	Detect anomalies
GET	`/mcp/alerts`	List alerts

Method	Endpoint	Description
GET	`/mcp/webhooks`	List webhooks
POST	`/mcp/webhooks`	Create webhook

Method	Endpoint	Description
GET	`/mcp/pricing`	Get model pricing