# Uso, gasto y huella

Leer las trazas de uso, el informe de gasto y ahorro, los presupuestos y su consumo, y la huella estimada de energía y de carbono.

[Toda la referencia de la API](https://www.azothos.ai/es/docs/api)

> Los resúmenes de las rutas y los nombres de los campos están en inglés, aquí y en el archivo.

## /api/v1/usage

### GET /api/v1/usage

The workspace's usage traces, newest first (paginated)

- **Autenticación** — Clave API
- **Ámbito de la clave** — `usage:read`
- **Parámetros** — `limit` · `offset` · `cursor` · `since` · `model` · `agentId` · `status`
- **Respuestas** — `200` · `400` [validation_failed](https://www.azothos.ai/es/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/es/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

## /api/v1/report

### GET /api/v1/report

The spend and savings report of the workspace

- **Autenticación** — Clave API
- **Ámbito de la clave** — `usage:read`
- **Parámetros** — `days` · `subscriptionCostUsd`
- **Respuestas** — `200` · `400` [validation_failed](https://www.azothos.ai/es/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/es/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/es/docs/errors#plan_required) · `429`

## /api/v1/budgets

### GET /api/v1/budgets

The workspace's budgets and their use

- **Autenticación** — Clave API
- **Ámbito de la clave** — `budgets:read`
- **Respuestas** — `200` · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/es/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error)

## /api/v1/greenops

### GET /api/v1/greenops/footprint

The workspace's estimated energy and carbon footprint, over an API key

- **Autenticación** — Clave API
- **Ámbito de la clave** — `usage:read`
- **Parámetros** — `periodDays`
- **Respuestas** — `200` · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/es/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops/energy

Energy per day and per strategy, and the workspace's energy budget

- **Autenticación** — Clave API o sesión iniciada
- **Parámetros** — `workspaceId` · `days` · `feature`
- **Respuestas** — `200` · `401` [api_key_missing](https://www.azothos.ai/es/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/es/docs/errors#api_key_invalid), [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden), [api_key_scope_denied](https://www.azothos.ai/es/docs/errors#api_key_scope_denied), [ip_not_allowed](https://www.azothos.ai/es/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error)

### GET /api/v1/greenops/summary

GreenOps key figures (the dashboard's read)

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops/carbon

Estimated carbon totals and their monthly trend (the dashboard's read)

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays` · `months`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops/provider-efficiency

Energy per 1,000 tokens, per provider and model (the dashboard's read)

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops/replay-savings

Energy saved by reusing answers (the dashboard's read)

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops/abatement

Avoided CO₂ with its traceability (the dashboard's read)

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)

### GET /api/v1/greenops

Obsoleta — Deprecated: use /api/v1/greenops/summary

- **Autenticación** — Sesión iniciada (el panel)
- **Parámetros** — `workspaceId` (obligatorio) · `periodDays`
- **Respuestas** — `200` · `400` [workspace_required](https://www.azothos.ai/es/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/es/docs/errors#session_required), [session_expired](https://www.azothos.ai/es/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/es/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/es/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/es/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/es/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/es/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/es/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/es/docs/errors#service_unavailable)
