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

# List audit log entries

> 
        Retrieve approved audit log entries: each change to a record, with who made it, who approved it,
        and the record's payload before and after. Entries are ordered newest first by (created_at, id).

        **Access:** customer admins, or users with the "View audit logs" permission. OAuth apps also need
        the `audit_logs:read` scope. Users restricted to some entities see only entries whose every entity
        they can access.

        **Filtering:**
        - `created_at__gte` (inclusive) and `created_at__lt` (exclusive) take an ISO 8601 date, read as
          00:00 UTC, or a datetime with a UTC offset. URL-encode the `+` in an offset as `%2B`.
        - `model` (as `app_label.model`) returns that object type; with `object_id` it returns that
          object's entries and the entries of records under it, such as a bill's payments.
        - Unknown parameters are rejected with a 400.

        **Paging:**
        - For a complete export, pass an empty cursor (`cursor=`) on the first request and follow the
          `next` URL until it is null. Entries written while you page don't shift later pages.
        - Pass `skip_count=true` when you don't need the total; `count` stops at 10,000.

        **Notes:**
        - The entry's `approved_by` is who gave final approval. Inside `approvers`, `approved_by` is the
          step's approver type and `approved_by_user` is who approved that step; it can be empty for
          steps approved before step approvers were recorded.
        - Entries recorded when data was first imported can appear later with historical `created_at` dates.
        - Payload fields that hold secrets are stored hashed.
        



## OpenAPI

````yaml https://api.meetcampfire.com/api/schema?format=json get /ca/api/v1/audit-log
openapi: 3.0.3
info:
  title: Campfire Developer APIs
  version: 1.0.0
  description: >
    ## Introduction

    Campfire's developer APIs offer granular access to Campfire's core
    accounting,

    revenue recognition, and financial data features.


    These APIs are designed to be used by developers to build custom
    integrations,

    automate workflows, and perform any other programmatic operations.


    ## Rate limits

    API users can make up to **10 requests per second**. This limit is shared
    across

    all endpoints for the same API user. OAuth app tokens get the same limit,

    counted separately for each app connection. Requests that exceed the limit
    receive a

    `429 Too Many Requests` response. Wait for the number of seconds specified
    in

    the `Retry-After` response header before retrying.
servers:
  - url: https://api.meetcampfire.com
    description: Production server
security: []
tags:
  - name: Cash Management
    description: Operations related to accounts, transactions, and other bank-related data.
  - name: Core Accounting
    description: >-
      Operations related to core accounting data, such as the chart of accounts,
      entity management, and the general ledger.
  - name: Revenue Recognition
    description: >-
      Operations related to revenue recognition, contract management, and
      contract data aggregation.
  - name: Accounts Receivable
    description: Operations related to invoicing and the AR subledger
  - name: Accounts Payable
    description: Operations related to billing and the AP subledger.
  - name: Financial Statements
    description: Operations related to financial statement generation and data aggregation.
  - name: Settings
    description: Operations related to system and accounting settings configuration.
paths:
  /ca/api/v1/audit-log:
    get:
      tags:
        - Settings
      summary: List audit log entries
      description: |2-

                Retrieve approved audit log entries: each change to a record, with who made it, who approved it,
                and the record's payload before and after. Entries are ordered newest first by (created_at, id).

                **Access:** customer admins, or users with the "View audit logs" permission. OAuth apps also need
                the `audit_logs:read` scope. Users restricted to some entities see only entries whose every entity
                they can access.

                **Filtering:**
                - `created_at__gte` (inclusive) and `created_at__lt` (exclusive) take an ISO 8601 date, read as
                  00:00 UTC, or a datetime with a UTC offset. URL-encode the `+` in an offset as `%2B`.
                - `model` (as `app_label.model`) returns that object type; with `object_id` it returns that
                  object's entries and the entries of records under it, such as a bill's payments.
                - Unknown parameters are rejected with a 400.

                **Paging:**
                - For a complete export, pass an empty cursor (`cursor=`) on the first request and follow the
                  `next` URL until it is null. Entries written while you page don't shift later pages.
                - Pass `skip_count=true` when you don't need the total; `count` stops at 10,000.

                **Notes:**
                - The entry's `approved_by` is who gave final approval. Inside `approvers`, `approved_by` is the
                  step's approver type and `approved_by_user` is who approved that step; it can be empty for
                  steps approved before step approvers were recorded.
                - Entries recorded when data was first imported can appear later with historical `created_at` dates.
                - Payload fields that hold secrets are stored hashed.
                
      operationId: ca_api_v1_audit_log_list
      parameters:
        - in: query
          name: action_type
          schema:
            type: array
            items:
              type: string
          description: created, updated or deleted. Repeat or comma-separate.
        - in: query
          name: approved_by
          schema:
            type: integer
            minimum: 1
          description: User who gave final approval.
        - in: query
          name: created_at__gte
          schema:
            type: string
            minLength: 1
          description: >-
            Start, inclusive. Use an ISO 8601 date or a datetime with a UTC
            offset, such as 2026-03-10T11:00:00-04:00.
        - in: query
          name: created_at__lt
          schema:
            type: string
            minLength: 1
          description: >-
            End, exclusive. Use an ISO 8601 date or a datetime with a UTC
            offset, such as 2026-03-10T11:00:00-04:00.
        - in: query
          name: created_by
          schema:
            type: integer
            minimum: 1
          description: User who made the change.
        - in: query
          name: cursor
          schema:
            type: string
          description: >-
            Opts into cursor pagination. Pass an empty value (cursor=) on the
            first request, then follow the next URL until it is null.
            Recommended for complete exports: rows written while paging don't
            shift pages, so none are skipped or repeated.
        - in: query
          name: limit
          schema:
            type: integer
            maximum: 10000
            minimum: 1
          description: Page size. Default 100, maximum 10000.
        - in: query
          name: model
          schema:
            type: string
            minLength: 1
          description: Object type as app_label.model. Open set.
        - in: query
          name: object_id
          schema:
            type: integer
            minimum: 1
          description: Rows for this object, or whose parent is this object. Needs model.
        - in: query
          name: offset
          schema:
            type: integer
            minimum: 0
          description: Number of records to skip. Use with limit to paginate.
        - in: query
          name: operation
          schema:
            type: string
            minLength: 1
          description: Raw operation, such as add or delete. Open set.
        - in: query
          name: parent_draft_queue
          schema:
            type: integer
            minimum: 1
          description: Rows written as part of this audit entry.
        - in: query
          name: skip_count
          schema:
            type: boolean
          description: When true, skips the total count. Recommended for large exports.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAuditLogEntrySchemaList'
          description: ''
        '400':
          description: An unknown parameter or an invalid filter value.
components:
  schemas:
    PaginatedAuditLogEntrySchemaList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/AuditLogEntrySchema'
    AuditLogEntrySchema:
      type: object
      description: >-
        The published shape of an audit entry, for the API docs;
        AuditLogEntrySerializer produces it.
      properties:
        id:
          type: integer
        operation:
          type: string
          nullable: true
          description: Raw operation, such as add, change or delete. Open set.
        model:
          type: string
          description: Object type as app_label.model. Open set.
        object_id:
          type: integer
          nullable: true
        parent_model:
          type: string
          nullable: true
        parent_object_id:
          type: integer
          nullable: true
        parent_draft_queue:
          type: integer
          nullable: true
          description: The audit entry this row was written as part of.
        created_by:
          type: integer
          nullable: true
        created_by_name:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        approved_by:
          type: integer
          nullable: true
          description: User who gave final approval.
        approved_by_name:
          type: string
          nullable: true
        approved_at:
          type: string
          format: date-time
          nullable: true
        notes:
          type: string
          nullable: true
        reason:
          type: string
          nullable: true
        old_payload:
          nullable: true
        new_payload:
          nullable: true
        workflow_name:
          type: string
          nullable: true
        approvers:
          type: array
          items:
            type: object
            additionalProperties: {}
          description: Each workflow step; [] when the row had no workflow.
      required:
        - approved_at
        - approved_by
        - approved_by_name
        - approvers
        - created_at
        - created_by
        - created_by_name
        - id
        - model
        - new_payload
        - notes
        - object_id
        - old_payload
        - operation
        - parent_draft_queue
        - parent_model
        - parent_object_id
        - reason
        - workflow_name

````