# Get Remaining Credits

Get the current remaining credits for a tenant.

## Overview
This endpoint retrieves the current remaining credits available for the authenticated tenant.

## Response Fields
- success: Boolean indicating request success
- tenant_id: The tenant ID
- remaining_credits: Current remaining credits for the tenant
- total_credits: Total credits for the tenant

## Authentication
This endpoint requires authentication via Bearer token. The tenant ID is automatically extracted from the authenticated user's token.

## Example Response
json
{
  "success": true,
  "tenant_id": 123,
  "remaining_credits": 4750.25
}

Endpoint: GET /v1/credits/remaining
Version: 1.4.1
Security: BearerAuth

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Boolean indicating request success

  - `tenant_id` (integer, required)
    Tenant ID

  - `remaining_credits` (number, required)
    Remaining credits for the tenant

  - `total_credits` (number, required)
    Total credits for the tenant

## Response 401 fields (application/json):

  - `success` (boolean)
    Boolean indicating request success

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

## Response 429 fields (application/json):

  - `success` (boolean)
    Boolean indicating request success

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

## Response 500 fields (application/json):

  - `success` (boolean)
    Boolean indicating request success

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details