> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blink.store/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Customer Meter Balance

> This endpoint fetches the credit balance per meter for a specific customer. The `x-store-id` header is required for authentication to verify the customer's association with the store. The response includes detailed information about each meter, such as the meter ID, meter name, and the remaining credits available for usage.

- **Parameters:**
  - `id` (string, path, required): The ID of the customer.

- **Responses:**
  - `200`: Returns a list with customer's remaining credits per meter.
  - `401`: Unauthorized if `x-store-id` is not provided.
  - `404`: Customer not found if the customer ID does not exist.



## OpenAPI

````yaml /api-reference/blink-api.json get /customers/{id}/meter-balance
openapi: 3.0.0
info:
  title: Blink API
  description: Comprehensive API documentation for Blink.
  version: 1.0.0
servers:
  - url: https://api.blink.store/v1
security:
  - storeIdHeader: []
tags:
  - name: Invoices
    description: Unified merchant of record invoices for products and subscriptions.
  - name: Geo Pricing
    description: Resolve Purchasing Power Parity (PPP) localized pricing.
paths:
  /customers/{id}/meter-balance:
    get:
      tags:
        - Customers
      summary: Retrieve Customer Meter Balance
      description: >-
        This endpoint fetches the credit balance per meter for a specific
        customer. The `x-store-id` header is required for authentication to
        verify the customer's association with the store. The response includes
        detailed information about each meter, such as the meter ID, meter name,
        and the remaining credits available for usage.


        - **Parameters:**
          - `id` (string, path, required): The ID of the customer.

        - **Responses:**
          - `200`: Returns a list with customer's remaining credits per meter.
          - `401`: Unauthorized if `x-store-id` is not provided.
          - `404`: Customer not found if the customer ID does not exist.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID of the customer.
      responses:
        '200':
          description: Customer meter balance retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerMeterBalance'
        '401':
          description: Unauthorized - Store ID header missing.
        '404':
          description: Customer not found.
      security:
        - storeIdHeader: []
components:
  schemas:
    CustomerMeterBalance:
      type: object
      properties:
        meta:
          type: object
          properties:
            total:
              type: integer
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              meter_id:
                type: string
              subscription_id:
                type: string
              total_credits:
                type: integer
              used_credits:
                type: integer
              remaining_credits:
                type: integer
              rollover_unused:
                type: boolean
              created_at:
                type: string
                format: date-time
              updated_at:
                type: string
                format: date-time
              meter:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  event_name:
                    type: string
                  unit:
                    type: string
  securitySchemes:
    storeIdHeader:
      type: apiKey
      in: header
      name: x-store-id

````