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

# Lister les requêtes

> Les appels faits avec les clés du compte, dans l'environnement de la clé, du plus récent au plus ancien. Les corps des requêtes et des réponses n'y figurent pas : ils restent dans le tableau de bord. Une requête apparaît quelques secondes après sa réponse. Les lectures de cette liste n'y figurent pas. Pour suivre les nouvelles requêtes, repassez l'`id` le plus récent en `ending_before`, comme le fait `mercypay logs tail`.



## OpenAPI

````yaml GET /api/v1/request_logs
openapi: 3.1.0
info:
  title: API Mercy Pay
  version: 1.0.0
  description: >-
    Encaissez par mobile money et par carte, facturez en récurrent et versez vos
    fonds. Les montants sont des entiers en unités mineures. Chaque réponse
    porte un en-tête `Request-Id`.
servers:
  - url: https://mercy-pay.com
    description: >-
      Production. La clé choisit l'environnement : `mp_sandbox_…` ou
      `mp_live_…`.
security:
  - bearerAuth: []
tags:
  - name: Compte
  - name: Sessions de paiement
  - name: Paiements
  - name: Remboursements
    description: Rendre un paiement au client, en entier.
  - name: Liens de paiement
  - name: Plans
  - name: Abonnements
  - name: Clients
  - name: Factures
  - name: Espace client
  - name: Soldes
  - name: Retraits
  - name: État des opérateurs
  - name: Événements
    description: Tout ce qui s'est passé sur le compte, envoyé ou non à un endpoint.
  - name: Endpoints de webhook
    description: Les URL de votre serveur qui reçoivent les événements.
  - name: Journal des requêtes
    description: >-
      Les appels faits avec vos clés, pour suivre une intégration depuis le
      terminal.
  - name: Sites autorisés
    description: Les sites sur lesquels le paiement intégré peut s'afficher.
paths:
  /api/v1/request_logs:
    get:
      tags:
        - Journal des requêtes
      summary: Lister les requêtes
      description: >-
        Les appels faits avec les clés du compte, dans l'environnement de la
        clé, du plus récent au plus ancien. Les corps des requêtes et des
        réponses n'y figurent pas : ils restent dans le tableau de bord. Une
        requête apparaît quelques secondes après sa réponse. Les lectures de
        cette liste n'y figurent pas. Pour suivre les nouvelles requêtes,
        repassez l'`id` le plus récent en `ending_before`, comme le fait
        `mercypay logs tail`.
      operationId: listRequestLogs
      parameters:
        - name: status
          in: query
          schema:
            type: string
            enum:
              - success
              - error
          description: '`success` (statut < 400) ou `error` (statut ≥ 400)'
        - name: method
          in: query
          schema:
            type: string
            enum:
              - GET
              - POST
              - PATCH
              - PUT
              - DELETE
          description: Une seule méthode HTTP
        - name: path
          in: query
          schema:
            type: string
          description: Partie du chemin, par exemple `payments`
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Nombre d'objets
        - name: starting_after
          in: query
          schema:
            type: string
          description: Le `next_cursor` de la page précédente
        - name: ending_before
          in: query
          schema:
            type: string
          description: Un id, pour revenir à la page d'avant
      responses:
        '200':
          description: Une page de requêtes
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: list
                  url:
                    type: string
                  has_more:
                    type: boolean
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: À passer en `starting_after` pour la page suivante
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/RequestLog'
              example:
                object: list
                url: /api/v1/request_logs
                has_more: false
                next_cursor: null
                data:
                  - id: req_01JCB7K2M4N6P8Q0R2S4T6V8X0
                    object: request_log
                    livemode: false
                    created: '2026-11-16T10:42:17+00:00'
                    method: POST
                    path: /v1/payments
                    status: 201
                    error_code: null
                    idempotency_key: order-4821
                    duration_ms: 184
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/ValidationFailed'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    RequestLog:
      type: object
      properties:
        id:
          type: string
          description: >-
            Identifiant de la requête (`req_…`), le même que l'en-tête
            `Request-Id` reçu
        object:
          type: string
          const: request_log
        livemode:
          type: boolean
          description: '`true` pour une clé live, `false` en sandbox'
        created:
          type:
            - string
            - 'null'
          format: date-time
          description: Date de la requête, ISO 8601
        method:
          type: string
          description: Méthode HTTP
          enum:
            - GET
            - POST
            - PATCH
            - PUT
            - DELETE
        path:
          type: string
          description: Chemin appelé, par exemple `/v1/payments`
        status:
          type: integer
          description: Statut HTTP renvoyé
        error_code:
          type:
            - string
            - 'null'
          description: Le `error.code` renvoyé, `null` si la requête a réussi
        idempotency_key:
          type:
            - string
            - 'null'
          description: La `Idempotency-Key` envoyée, s'il y en avait une
        duration_ms:
          type: integer
          description: Durée de traitement, en millisecondes
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - authentication_error
                - invalid_request_error
                - idempotency_error
                - payment_error
                - rate_limit_error
                - api_error
            code:
              type: string
              description: Code stable, à tester dans votre code
            message:
              type: string
              description: Explication en français, pour un humain
            param:
              type:
                - string
                - 'null'
              description: Le premier champ en cause
            doc_url:
              type: string
              description: Explication de ce code
            request_id:
              type: string
              description: >-
                Identifiant de la requête (`req_…`), aussi dans l'en-tête
                `Request-Id`
            errors:
              type: object
              additionalProperties:
                type: array
                items:
                  type: string
              description: Détail par champ refusé, sur une erreur `422`
      required:
        - error
  responses:
    Unauthorized:
      description: Clé absente, invalide ou révoquée
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              type: authentication_error
              code: api_key_invalid
              message: Clé API invalide.
              param: null
              doc_url: https://docs.mercy-pay.com/developers/errors#api_key_invalid
              request_id: req_01jc8x4m2v7t9qk3n5w6y8z0ab
    ValidationFailed:
      description: Données invalides, avec le détail dans `errors`
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              type: invalid_request_error
              code: validation_failed
              message: Le champ amount est obligatoire.
              param: amount
              doc_url: https://docs.mercy-pay.com/developers/errors#validation_failed
              request_id: req_01jc8x4m2v7t9qk3n5w6y8z0ab
              errors:
                amount:
                  - Le champ amount est obligatoire.
    RateLimited:
      description: Plus de 60 requêtes par minute avec cette clé
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              type: rate_limit_error
              code: rate_limited
              message: Trop de requêtes.
              param: null
              doc_url: https://docs.mercy-pay.com/developers/errors#rate_limited
              request_id: req_01jc8x4m2v7t9qk3n5w6y8z0ab
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Votre clé API. Utilisez une clé sandbox (`mp_sandbox_…`) pour essayer :
        aucun argent réel ne bouge.

````

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