# Usage et facturation

Consommation, plan et identité de la plateforme.

## Consommation par jour, catégorie, pays ou numéro

`GET /usage`

Authentification : clé API, ou session de la console avec X-Environment-Id · portée : usage:read

Le coût Meta est une ESTIMATION calculée avec la grille tarifaire configurée ; `unpricedMessages` compte les messages facturables sans tarif configuré. Les frais BrefPoint sont séparés et jamais ajoutés au coût Meta.

Paramètres :

| Nom | Emplacement | Type | Description |
|---|---|---|---|
| `from` | query | string | Début (inclus), ISO 8601. Défaut : début du mois en cours (UTC) |
| `to` | query | string | Fin (exclue), ISO 8601 |
| `groupBy` | query | string | Regroupement : `day` (défaut), `category`, `country` ou `phone_number`. |

```bash
curl "$INBOX_API/usage" \
  -H "Authorization: Bearer $INBOX_KEY"
```

Réponse 200 :

```json
{
  "from": "2026-11-01T00:00:00.000Z",
  "to": "2026-12-01T00:00:00.000Z",
  "groupBy": "day",
  "totals": {
    "messages": 0,
    "billableMessages": 0,
    "notBillableMessages": 0,
    "unpricedMessages": 0,
    "metaCostEstimate": {},
    "platformFee": {}
  },
  "buckets": [],
  "metaCostIsEstimate": true
}
```

## Plan, consommation de la période et limites (portail)

`GET /billing/overview`

Authentification : session du portail

```bash
curl "$INBOX_API/billing/overview" \
  -H "Authorization: Bearer $INBOX_SESSION"
```

Réponse 200 :

```json
{
  "plan": {
    "id": "654e934f-a17e-4c05-8964-b1febb33b2b5",
    "code": "free",
    "name": "Gratuit",
    "monthlyPriceAmount": null,
    "currency": null,
    "includedMessages": 100,
    "hardMessageLimit": 100,
    "maxConnectedBusinesses": 1,
    "maxNumbersPerBusiness": 1,
    "overageFeePerMessage": 0,
    "logRetentionDays": 3
  },
  "period": {
    "start": "2026-11-01T00:00:00.000Z",
    "end": "2026-12-01T00:00:00.000Z"
  },
  "messages": {
    "used": 0,
    "included": 100,
    "hardLimit": 100
  },
  "connectedBusinesses": {
    "used": 0,
    "max": 1
  }
}
```

## Identité commerciale et légale de la plateforme (publique)

`GET /platform`

Authentification : aucune

```bash
curl "$INBOX_API/platform"
```

Réponse 200 :

```json
{
  "brand": {
    "name": "Bref Point Inbox",
    "tagline": "One API. Every conversation.",
    "website": null,
    "supportEmail": null
  },
  "legal": {
    "name": "Labred Industry",
    "address": null,
    "taxId": null
  },
  "notice": "Bref Point Inbox est un produit indépendant, édité par Labred Industry. Il n'est ni édité, ni approuvé par Meta."
}
```