# الاستخدام والإنفاق والبصمة

قراءة آثار الاستخدام، وتقرير الإنفاق والوفورات، والميزانيات واستهلاكها، والبصمة التقديرية من الطاقة والكربون.

[مرجع واجهة API كاملًا](https://www.azothos.ai/ar/docs/api)

> ملخصات المسارات وأسماء الحقول مكتوبة بالإنجليزية، هنا وفي الملف.

## /api/v1/usage

### GET /api/v1/usage

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

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `usage:read`
- **المعاملات** — `limit` · `offset` · `cursor` · `since` · `model` · `agentId` · `status`
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

## /api/v1/report

### GET /api/v1/report

The spend and savings report of the workspace

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `usage:read`
- **المعاملات** — `days` · `subscriptionCostUsd`
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/ar/docs/errors#plan_required) · `429`

## /api/v1/budgets

### GET /api/v1/budgets

The workspace's budgets and their use

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `budgets:read`
- **الإجابات** — `200` · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error)

## /api/v1/greenops

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

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

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `usage:read`
- **المعاملات** — `periodDays`
- **الإجابات** — `200` · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

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

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

- **المصادقة** — مفتاح API أو جلسة مسجّلة
- **المعاملات** — `workspaceId` · `days` · `feature`
- **الإجابات** — `200` · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid), [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden), [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error)

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

GreenOps key figures (the dashboard's read)

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

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

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

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays` · `months`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

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

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

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

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

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

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

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

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

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

### GET /api/v1/greenops

مُهمَل — Deprecated: use /api/v1/greenops/summary

- **المصادقة** — جلسة مسجّلة (لوحة التحكم)
- **المعاملات** — `workspaceId` (إلزامي) · `periodDays`
- **الإجابات** — `200` · `400` [workspace_required](https://www.azothos.ai/ar/docs/errors#workspace_required) · `401` [session_required](https://www.azothos.ai/ar/docs/errors#session_required), [session_expired](https://www.azothos.ai/ar/docs/errors#session_expired), [mfa_challenge_required](https://www.azothos.ai/ar/docs/errors#mfa_challenge_required) · `403` [not_a_member](https://www.azothos.ai/ar/docs/errors#not_a_member), [mfa_required_by_workspace](https://www.azothos.ai/ar/docs/errors#mfa_required_by_workspace), [forbidden](https://www.azothos.ai/ar/docs/errors#forbidden) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `503` [membership_lookup_failed](https://www.azothos.ai/ar/docs/errors#membership_lookup_failed), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)
