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

# List seller payout batch activities

> Retrieves a paginated audit trail of events recorded while payout batches are processed. Each `SellerPayoutBatchActivity` names the `batch_id` it belongs to and, for gateway-facing events, captures the request and response exchanged with the payout provider. Use it to diagnose batches stuck in `processing` or left `failed`.



## OpenAPI

````yaml https://openapi.commercengine.io/ce-admin.json get /orders/payouts/invoices/batches/activities
openapi: 3.1.0
info:
  title: CE Admin APIs
  version: '1.0'
  summary: Comprehensive admin interface for managing your e-commerce platform
  description: >-
    Complete administrative API suite for Commerce Engine, providing powerful
    tools to manage products, orders, customers, inventory, analytics, and
    system configuration. Designed for administrators and backend integrations
    requiring full platform control.
  license:
    name: All Rights Reserved
    url: https://www.commercengine.io/contact-us
  contact:
    email: support@commercengine.io
    url: https://www.commercengine.io/contact-us
    name: Support
servers:
  - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin
    description: Staging Server
    variables:
      store_id:
        default: store_id
        description: Store ID
  - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin
    description: Prod Server
    variables:
      store_id:
        default: store_id
        description: Store ID
security:
  - Authorization: []
tags:
  - name: Analytics
    description: Analytics
  - name: Catalog
    description: Catalog
  - name: Coupons & promotions
    description: Coupons & promotions
  - name: Customers
    description: Customers
  - name: Filter Options
    description: Filter Options
  - name: Inventories
    description: Inventories
  - name: Marketplace
    description: Marketplace
  - name: Marketplace Catalog
    description: Marketplace Catalog
  - name: Media Gallery
    description: Media Gallery
  - name: Metrics
    description: Metrics
  - name: Orders
    description: Orders
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: POS
    description: POS
  - name: Segments
    description: Segments
  - name: Shipping
    description: Shipping
  - name: SSE
    description: SSE
  - name: Store
    description: Store
  - name: Webhooks
    description: Webhooks
paths:
  /orders/payouts/invoices/batches/activities:
    parameters: []
    get:
      tags:
        - Payouts
      summary: List seller payout batch activities
      description: >-
        Retrieves a paginated audit trail of events recorded while payout
        batches are processed. Each `SellerPayoutBatchActivity` names the
        `batch_id` it belongs to and, for gateway-facing events, captures the
        request and response exchanged with the payout provider. Use it to
        diagnose batches stuck in `processing` or left `failed`.
      operationId: list-seller-payout-batch-activities
      parameters:
        - $ref: '#/components/parameters/pageNumber'
        - $ref: '#/components/parameters/pageLimit'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                  content:
                    properties:
                      activities:
                        type: array
                        items:
                          $ref: '#/components/schemas/SellerPayoutBatchActivity'
                      pagination:
                        $ref: '#/components/schemas/Pagination'
                    type: object
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    pageNumber:
      name: page
      in: query
      required: false
      schema:
        type: integer
        default: 1
        minimum: 1
      description: page number of pagination list
    pageLimit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        default: 25
        minimum: 1
      description: no of rows per page
  schemas:
    SellerPayoutBatchActivity:
      title: SellerPayoutBatchActivity
      description: >-
        An audit entry recorded while a seller payout batch is processed,
        including the raw exchange with the payout provider.
      type: object
      properties:
        batch_id:
          description: ULID of the `SellerPayoutBatch` the event was recorded against.
          type: string
        created_at:
          type: string
          format: date-time
        duration_ms:
          description: >-
            Round-trip time of the provider call. `null` for events that make no
            outbound request.
          type:
            - integer
            - 'null'
        event:
          description: >-
            Dot-namespaced event key, for example
            `payout_batch.gateway_unavailable`.
          type: string
        id:
          description: Activity ULID.
          type: string
        modified_at:
          type: string
          format: date-time
        reference_field:
          description: >-
            Field on `reference_type` that `reference_id` matches, for example
            `id`.
          type:
            - string
            - 'null'
        reference_id:
          description: Value identifying the record the event was raised against.
          type:
            - string
            - 'null'
        reference_type:
          description: Record the event relates to, such as `seller_payout_batch`.
          type:
            - string
            - 'null'
        remarks:
          description: >-
            Human-readable detail about the event, such as why a batch could not
            be processed.
          type:
            - string
            - 'null'
        request_endpoint:
          description: >-
            Provider endpoint called. `null` for events that make no outbound
            request.
          type:
            - string
            - 'null'
        request_payload:
          description: >-
            Body sent to the provider. `null` for events that make no outbound
            request.
          type:
            - object
            - 'null'
          additionalProperties: true
        response_body:
          description: >-
            Body returned by the provider. `null` for events that make no
            outbound request.
          type:
            - object
            - 'null'
          additionalProperties: true
        response_code:
          description: >-
            HTTP status returned by the provider. `null` for events that make no
            outbound request.
          type:
            - integer
            - 'null'
        response_headers:
          description: >-
            Headers returned by the provider. `null` for events that make no
            outbound request.
          type:
            - object
            - 'null'
          additionalProperties:
            type: string
        timestamp:
          description: >-
            When the event occurred. `created_at` is when the activity record
            was written.
          type: string
          format: date-time
      x-tags:
        - Payouts
    Pagination:
      title: Pagination
      description: pagination metadata structure
      type: object
      properties:
        total_records:
          type: integer
        total_pages:
          type: integer
        previous_page:
          description: Previous page number
          type:
            - integer
            - 'null'
        limit:
          type: integer
          default: 25
        next_page:
          description: Next page number
          type:
            - integer
            - 'null'
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              success:
                type: boolean
              code:
                type: string
              error:
                type: object
                properties:
                  fieldname:
                    type: array
                    items:
                      type: string
    Unauthorized:
      description: Not authorized for given operation on the Resource
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Not authorized for given operation on the Resource.
              success:
                type: boolean
                default: false
              code:
                type: string
                example: unauthorized
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````