Aller au contenu
API HILLS v1 Accès anticipé

Référence API

Versements

Votre solde chez HILLS Music et vos demandes de retrait.

Votre solde chez HILLS Music et vos demandes de retrait.

URL de base https://api.hillsmusic.com/v1. Chaque requête envoie une clé d’API : Authorization: Bearer hm_live_….

  • Solde et versements

Solde et versements

GET /v1/payouts · Scope : payouts:read

Votre solde chez HILLS Music (en cents) et vos demandes de retrait, de la plus récente à la plus ancienne.

Exemple de requête

curl "https://api.hillsmusic.com/v1/payouts" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Réponse 200

{
  "balance": {
    "currency": "USD",
    "earned_cents": 254000,
    "reserved_cents": 100000,
    "paid_cents": 100000,
    "manual_cents": 0,
    "available_cents": 154000
  },
  "data": [
    {
      "id": 9,
      "amount_cents": 100000,
      "currency": "USD",
      "status": "completed",
      "failed_reason": null,
      "created_at": "2026-09-01T09:00:00Z",
      "approved_at": "2026-09-02T09:00:00Z",
      "completed_at": "2026-09-04T09:00:00Z"
    }
  ]
}

Erreurs

Statut Quand
401 unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired.
403 insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan.
429 rate_limited : attendez le nombre de secondes indiqué par Retry-After.

Prêt à vous intégrer ?

Demandez l’accès à l’API : nous vous répondons sous 1–3 business days.