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

# Validate Electricity Meter

> Verify electricity meter ownership before purchase

## Overview

Validate an electricity meter number against the specified distribution company (DisCo) to ensure it belongs to a valid customer and retrieve their details.

## Request Body

<RequestField name="meter" type="string" required>
  Customer meter number.
</RequestField>

<RequestField name="disco" type="string" required>
  Electricity provider `productCode` from the electricity catalog.
</RequestField>

<RequestField name="vendType" type="string" required>
  Meter type, such as `PREPAID` or `POSTPAID`.
</RequestField>

## Response Fields

<ResponseField name="name" type="string">
  Customer name returned for the meter.
</ResponseField>

<ResponseField name="address" type="string">
  Customer address returned for the meter.
</ResponseField>

<ResponseField name="minAmount" type="number">
  Minimum amount accepted for the meter.
</ResponseField>

<ResponseField name="outstanding" type="number">
  Outstanding amount returned for the meter, when available.
</ResponseField>

## Notes

* Call [Electricity Providers](/api-reference/endpoint/electricitylist) first and use the returned `productCode` as `disco`.
* `vendType` should match the customer's meter type, such as `PREPAID` or `POSTPAID`.
* Show the returned customer name, address, minimum amount, and outstanding amount to the customer before purchase.


## OpenAPI

````yaml POST /validateMeter
openapi: 3.0.3
info:
  title: Bleeprs API Specification 0.1
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.bleeprs.com/api
security:
  - bearerAuth: []
paths:
  /validateMeter:
    post:
      tags:
        - Vending
      summary: Validate Electricity Meter
      description: >-
        Verify an electricity meter before purchase and return customer details
        needed for confirmation.
      operationId: validateMeter
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                meter:
                  type: string
                  description: The electricity meter number to validate
                  example: '12345678910'
                disco:
                  type: string
                  description: >-
                    Electricity provider productCode returned by the
                    ElectricityList endpoint
                  example: IKEJA_ELECTRIC
                vendType:
                  type: string
                  description: Meter type
                  enum:
                    - PREPAID
                    - POSTPAID
                  example: PREPAID
              required:
                - meter
                - disco
                - vendType
      responses:
        '200':
          description: Successfully Processed
          content:
            application/json:
              schema:
                type: object
                properties:
                  gatewayStatus:
                    type: string
                    example: '00'
                  gatewayMessage:
                    type: string
                    example: Successfully Processed
                  requestReference:
                    type: string
                    example: bpr_req_a1b2c3d4e5f6
                  data:
                    type: object
                    properties:
                      name:
                        type: string
                        example: JOHN DOE
                      address:
                        type: string
                        example: 123 TEST STREET, IKEJA
                      minAmount:
                        type: number
                        example: 1000
                      outstanding:
                        type: number
                        example: 0
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````