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

# Vérifier un compteur

> Rend le nom du client et le minimum du fournisseur, avant de vendre. Pour SOCODE et TV ; VIRUNGA n'a pas de vérification.

Portée de la clé : `compteurs:lire`.



## OpenAPI

````yaml openapi/v1.json GET /v1/compteurs/{reference}
openapi: 3.1.0
info:
  title: API Umeme pour les intégrateurs
  version: 1.0.0
  description: >-
    Contrat de l'API Umeme pour les intégrateurs : vendre de l'électricité
    prépayée et des abonnements TV depuis le portefeuille de votre revendeur.
servers:
  - url: https://sandbox.umeme.app
    description: Sandbox d'intégration
  - url: https://api.umeme.app
    description: Production
security:
  - cle: []
tags:
  - name: Ventes
  - name: Compteurs
  - name: Portefeuille
  - name: Outils
paths:
  /v1/compteurs/{reference}:
    get:
      tags:
        - Compteurs
      summary: Vérifier un compteur
      description: >-
        Rend le nom du client et le minimum du fournisseur, avant de vendre.
        Pour SOCODE et TV ; VIRUNGA n'a pas de vérification.


        Portée de la clé : `compteurs:lire`.
      operationId: verifierCompteur
      parameters:
        - name: reference
          in: path
          required: true
          description: Le compteur, à 11 chiffres, ou la référence d'abonnement TV.
          schema:
            type: string
          example: '09900000000'
        - name: compte
          in: query
          required: true
          description: Le compte.
          schema:
            type: string
            enum:
              - SOCODE
              - TV
          example: SOCODE
        - name: montant
          in: query
          required: true
          description: Le montant envisagé, en dollars ; il sert au calcul du minimum.
          schema:
            type: number
          example: 5
      responses:
        '200':
          description: Le compteur existe.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Compteur'
              example:
                reference: '09900000000'
                client: CLIENT SANDBOX 0000
                minimum: 1
        '400':
          description: Référence mal formée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
              example:
                code: REFERENCE_INVALIDE
                message: Le compteur doit compter 11 chiffres.
        '401':
          $ref: '#/components/responses/NonAuthentifie'
        '404':
          description: Compteur inconnu du fournisseur.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
              example:
                code: COMPTEUR_INCONNU
                message: Compteur inconnu du fournisseur.
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            REFERENCE="09900000000"

            curl -G "$UMEME_BASE_URL/compteurs/$REFERENCE" \
              -H "Authorization: Bearer $UMEME_CLE" \
              --data-urlencode "compte=SOCODE" \
              --data-urlencode "montant=5"
        - lang: javascript
          label: Node.js · fetch
          source: >-
            // Node.js 18 et plus : fetch est intégré.

            const baseUrl = process.env.UMEME_BASE_URL;


            const reference = "09900000000";

            const params = new URLSearchParams({
              compte: "SOCODE",
              montant: "5",
            });


            const reponse = await
            fetch(`${baseUrl}/compteurs/${reference}?${params}`, {
              headers: {
                Authorization: `Bearer ${process.env.UMEME_CLE}`,
              },
            });

            const donnees = await reponse.json();
        - lang: javascript
          label: Node.js · Axios
          source: |-
            // npm install axios
            import axios from "axios";

            const umeme = axios.create({
              baseURL: process.env.UMEME_BASE_URL,
              headers: { Authorization: `Bearer ${process.env.UMEME_CLE}` },
              timeout: 30000,
            });

            const reference = "09900000000";

            const { data } = await umeme.get(`/compteurs/${reference}`, {
              params: {
                compte: "SOCODE",
                montant: 5,
              },
            });
        - lang: python
          label: Python
          source: |-
            import os

            import requests

            BASE_URL = os.environ["UMEME_BASE_URL"]
            ENTETES = {"Authorization": f"Bearer {os.environ['UMEME_CLE']}"}

            reference = "09900000000"

            reponse = requests.get(
                f"{BASE_URL}/compteurs/{reference}",
                headers=ENTETES,
                params={
                    "compte": "SOCODE",
                    "montant": 5,
                },
                timeout=30,
            )
            donnees = reponse.json()
        - lang: php
          label: PHP
          source: |-
            // composer require guzzlehttp/guzzle
            $client = new GuzzleHttp\Client([
                'base_uri' => getenv('UMEME_BASE_URL') . '/',
                'headers' => ['Authorization' => 'Bearer ' . getenv('UMEME_CLE')],
                'timeout' => 30,
            ]);

            $reference = '09900000000';

            $reponse = $client->get("compteurs/{$reference}", [
                'query' => [
                    'compte' => 'SOCODE',
                    'montant' => 5,
                ],
            ]);
            $donnees = json_decode($reponse->getBody(), true);
        - lang: java
          label: Java
          source: >-
            // Java 15 et plus : java.net.http et blocs de texte.

            var baseUrl = System.getenv("UMEME_BASE_URL");

            var client = HttpClient.newHttpClient();


            var reference = "09900000000";

            var params = Map.of("compte", "SOCODE", "montant",
            "5").entrySet().stream()
                .map(p -> p.getKey() + "=" + URLEncoder.encode(p.getValue(), StandardCharsets.UTF_8))
                .collect(Collectors.joining("&"));

            var requete = HttpRequest.newBuilder(URI.create(baseUrl +
            "/compteurs/" + reference + "?" + params))
                .header("Authorization", "Bearer " + System.getenv("UMEME_CLE"))
                .GET()
                .build();

            var reponse = client.send(requete,
            HttpResponse.BodyHandlers.ofString());
components:
  schemas:
    Compteur:
      type: object
      required:
        - reference
        - client
        - minimum
      properties:
        reference:
          type: string
          description: La référence vérifiée.
        client:
          type: string
          description: Le nom du client, à afficher pour confirmation.
        minimum:
          type: number
          description: Le montant minimum accepté par le fournisseur, en dollars.
    Erreur:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: 'Stable : il ne se renomme jamais. C''est lui que votre code compare.'
        message:
          type: string
          description: En français, pour vos journaux. Il peut changer.
  responses:
    NonAuthentifie:
      description: >-
        Clé absente, inconnue, révoquée, ou de l'autre environnement :
        `CLE_INVALIDE`, `CLE_REVOQUEE`, `CLE_MAUVAIS_ENVIRONNEMENT`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erreur'
          example:
            code: CLE_INVALIDE
            message: La clé est absente ou inconnue.
  securitySchemes:
    cle:
      type: http
      scheme: bearer
      description: >-
        Votre clé d'API : `umeme_test_…` dans la sandbox, `umeme_live_…` en
        production.

````

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