GET /v1/balance

Dette skrivebeskyttede endepunktet validerer API-nøkkelen, men krever ikke en positiv saldo.

Forespørsel

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

Svar

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

For individuell legitimasjon tilhører saldoen brukeren som eier nøkkelen. For bedriftslegitimasjon bruker API-avgifter alltid bedriftseierens lommebok. Den delte selskapssaldoen returneres bare når påloggingsoppdragsgiveren har saldosynlighet på selskapsnivå (organisasjonseier, administrator eller faktureringsrolle). Ansatts utvikler-/seerlegitimasjon kan utføre tillatte API-forespørsler, men motta HTTP 403 fra /v1/balance; disse brukerne ser bare deres tillatte gruppebruk og grenser i kontrollpanelet. API-nøkkel usage og spend_limit forbli separate verdier.

Autentiseringsfeil

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

Feil med bedriftstillatelse

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}