> ## 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.

# Services

> Dit quels comptes sont ouverts en ce moment. Un compte fermé rejette les ventes avec `SERVICE_INDISPONIBLE`.

Toute clé valide.



## OpenAPI

````yaml openapi/v1.json GET /v1/services
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/services:
    get:
      tags:
        - Outils
      summary: Services
      description: >-
        Dit quels comptes sont ouverts en ce moment. Un compte fermé rejette les
        ventes avec `SERVICE_INDISPONIBLE`.


        Toute clé valide.
      operationId: lireServices
      responses:
        '200':
          description: Un élément par compte.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Services'
              example:
                services:
                  - compte: SOCODE
                    ouvert: true
                  - compte: VIRUNGA
                    ouvert: true
                  - compte: TV
                    ouvert: false
        '401':
          $ref: '#/components/responses/NonAuthentifie'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl "$UMEME_BASE_URL/services" \
              -H "Authorization: Bearer $UMEME_CLE"
        - lang: javascript
          label: Node.js · fetch
          source: |-
            // Node.js 18 et plus : fetch est intégré.
            const baseUrl = process.env.UMEME_BASE_URL;

            const reponse = await fetch(`${baseUrl}/services`, {
              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 { data } = await umeme.get("/services");
        - lang: python
          label: Python
          source: |-
            import os

            import requests

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

            reponse = requests.get(
                f"{BASE_URL}/services",
                headers=ENTETES,
                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,
            ]);

            $reponse = $client->get('services');
            $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 requete = HttpRequest.newBuilder(URI.create(baseUrl +
            "/services"))
                .header("Authorization", "Bearer " + System.getenv("UMEME_CLE"))
                .GET()
                .build();

            var reponse = client.send(requete,
            HttpResponse.BodyHandlers.ofString());
components:
  schemas:
    Services:
      type: object
      required:
        - services
      properties:
        services:
          type: array
          items:
            type: object
            required:
              - compte
              - ouvert
            properties:
              compte:
                $ref: '#/components/schemas/Compte'
              ouvert:
                type: boolean
                description: '`true` si le compte vend en ce moment.'
    Compte:
      type: string
      enum:
        - SOCODE
        - VIRUNGA
        - TV
      description: Ce que l'on vend, et chez quel fournisseur.
    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.