# GET /v1/earnings

Obtenir les revenus

Revenus quotidiens sur une période, avec le solde actuel. Nécessite la portée `publisher:read` (clé API ou session web). Niveau de limite de débit : `read`.

- Portée requise: `publisher:read`
- Limite débit: `read` — 120 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

| Nom | Dans | Type | Requis |
|---|---|---|---|
| `from` | query | string | oui |
| `to` | query | string | oui |

## Réponse

```
{ adjustments: { amount: string; detected_on: string; earnings_day_id: integer; for_date: string; source: "network" | "dispute" }[]; balance: { available: string; held: string; min_payout: string; paid_total: string; pending: string; requested: string }; count_basis?: "valid" | "legacy" | "mixed"; currency: "USD"; days: { adjustment: string; count_basis?: "valid" | "legacy" | "mixed"; date: string; pops: integer; revenue: string; status?: "estimated" | "reported" | "final" | "mixed" }[]; estimated_at?: string | null; forecast_basis_version?: "forecast-basis-v1"; forecast_generation?: string; forecast_updated_at?: string | null; measurement_definition?: { complete: boolean; includes_direct: boolean; includes_legacy: boolean; tag_valid_after_ms: integer[] }; measurement_generation?: string; measurement_status?: "ok" | "stale" | "updating"; measurement_updated_at?: string | null; money_basis_version?: string; money_generation?: string; updated_at?: string | null }
```

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |
| 503 | Default Response |

Documentation HTML: https://agimone.com/fr/developers/api/#get-earnings
API 2026-10
