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

# Meter Enquiry

> Validate a meter number and resolve its customer name. Confirm the name with your customer before buying electricity, and send it back as `customer_name` on the purchase.



## OpenAPI

````yaml get /v1/bills/meter-enquiry
openapi: 3.0.3
info:
  title: Glyde Public API
  description: Glyde API for payments, collections, transfers, and virtual accounts
  version: 1.0.0
servers:
  - url: https://api.useglyde.co
    description: Production
  - url: https://sandbox.useglyde.co
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Account verification and bank listing
  - name: Collection
    description: Accept payments from customers
  - name: Transfers
    description: Send money to bank accounts. Available in NGN and ZAR
  - name: Transactions
    description: Transaction history and details
  - name: Settlements
    description: Settlement management
  - name: Wallet
    description: Per-currency wallet balances
  - name: Verification
    description: Identity verification
  - name: Virtual Accounts
    description: Virtual account management
  - name: Bills
    description: Buy airtime, data, electricity and cable TV from your naira wallet
paths:
  /v1/bills/meter-enquiry:
    get:
      tags:
        - Bills
      summary: Meter Enquiry
      description: >-
        Validate a meter number and resolve its customer name. Confirm the name
        with your customer before buying electricity, and send it back as
        `customer_name` on the purchase.
      operationId: billsMeterEnquiry
      parameters:
        - name: service_code
          in: query
          required: true
          schema:
            type: string
          description: >-
            An electricity biller's service code from List Billers
            (`category=electricity`)
          example: ikeja-electric-prepaid
        - name: meter_number
          in: query
          required: true
          schema:
            type: string
          description: The customer's meter number
          example: '04123456789'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  message:
                    type: string
                    example: Meter validated
                  data:
                    type: object
                    properties:
                      meter_number:
                        type: string
                        example: '04123456789'
                      customer_name:
                        type: string
                        example: John Doe
                      address:
                        type: string
                        nullable: true
                        example: 12 Allen Avenue, Ikeja
                      access_token:
                        type: string
                        nullable: true
                        description: >-
                          Returned by some billers. When present, send it as
                          `access_token` on the electricity purchase.
                        example: null
        '422':
          description: Validation error, or the meter number could not be validated
        '503':
          $ref: '#/components/responses/BillsUnavailable'
components:
  responses:
    BillsUnavailable:
      description: >-
        Bill payments are switched off for your business, or the biller could
        not be reached. Try again shortly.
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: >-
                  Bill payments are temporarily unavailable. Please try again
                  shortly.
              errors:
                type: object
                nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.