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

# Export Audit Logs

> ### Export Audit Logs (async bulk export)

Triggers a background task to export audit log entries matching the given
filters as CSV or JSON. Only MERCHANT_ADMIN can trigger exports.

Returns immediately with a `taskId`. Poll
`GET /giftcards/audit-logs/export/{taskId}` to check status and get the download URL.



## OpenAPI

````yaml https://api.loyalty.dog/openapi.json post /v2/giftcards/audit-logs/export
openapi: 3.1.0
info:
  title: LoyaltyDog
  description: >-

    Welcome to the LoyaltyDog API! This API provides access to our loyalty
    program features, allowing you to integrate with various platforms and
    manage your loyalty data.


    Want to query LoyaltyDog via an AI assistant (Claude, Cursor, Windsurf)? See
    the [MCP Integration guide](https://loyaltydog.ai/playground#mcp).
        
  termsOfService: https://loyalty.dog/loyalty-program-terms-service
  contact:
    name: LoyaltyDog Support
    url: https://loyalty.dog/contact-us
    email: support@loyalty.dog
  version: 1.0.1
servers:
  - url: https://api.loyalty.dog
    description: Production
security:
  - bearerAuth: []
paths:
  /v2/giftcards/audit-logs/export:
    post:
      tags:
        - Audit Logs
      summary: Export Audit Logs
      description: >-
        ### Export Audit Logs (async bulk export)


        Triggers a background task to export audit log entries matching the
        given

        filters as CSV or JSON. Only MERCHANT_ADMIN can trigger exports.


        Returns immediately with a `taskId`. Poll

        `GET /giftcards/audit-logs/export/{taskId}` to check status and get the
        download URL.
      operationId: export_audit_logs_v2_giftcards_audit_logs_export_post
      parameters:
        - name: X-Eposn-Merchant-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Eposn-Merchant-Token
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportRequest'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ExportRequest:
      properties:
        format:
          type: string
          title: Format
          default: csv
        merchantId:
          anyOf:
            - type: string
            - type: 'null'
          title: Merchantid
        subjectId:
          anyOf:
            - type: string
            - type: 'null'
          title: Subjectid
        actorId:
          anyOf:
            - type: string
            - type: 'null'
          title: Actorid
        subjectName:
          anyOf:
            - type: string
            - type: 'null'
          title: Subjectname
        actorName:
          anyOf:
            - type: string
            - type: 'null'
          title: Actorname
        merchantName:
          anyOf:
            - type: string
            - type: 'null'
          title: Merchantname
        actions:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Actions
        resourceTypes:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Resourcetypes
        fromDate:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Fromdate
        toDate:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Todate
      type: object
      title: ExportRequest
    ExportStatusResponse:
      properties:
        taskId:
          type: string
          title: Taskid
        status:
          type: string
          title: Status
        downloadUrl:
          anyOf:
            - type: string
            - type: 'null'
          title: Downloadurl
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
      type: object
      required:
        - taskId
        - status
      title: ExportStatusResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from POST /v2/token.

````