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

# Snapshot history

> Daily snapshots, newest first. Pass `nextCursor` as `cursor` to load the next (older) page.



## OpenAPI

````yaml /openapi.json get /usage/bases/{id}/snapshots
openapi: 3.0.4
info:
  title: Simplified Webhooks Backend
  version: '1.0'
  description: >-
    API for Airtable webhooks, usage (record & storage counts), and
    change-monitoring audit logs.
  contact:
    name: API Support
    url: https://www.simplified-webhooks.com/contact-us
    email: contact@simplified-webhooks.com
  x-generated: backend/scripts/generate-openapi.ts — do not edit by hand
servers:
  - url: https://api.simplified-webhooks.com
    description: Main server
security: []
tags:
  - name: Webhooks
    description: Receive Airtable change notifications at your own HTTPS URL.
  - name: Usage
    description: Daily record counts and attachment storage for your Airtable bases.
  - name: Audit Log
    description: >-
      Log record and schema changes into a Changes table in your own Airtable
      Monitoring Base.
  - name: Airtable Helpers
    description: Look up base, table, and field ids from your connected Airtable account.
paths:
  /usage/bases/{id}/snapshots:
    get:
      tags:
        - Usage
      summary: Snapshot history
      description: >-
        Daily snapshots, newest first. Pass `nextCursor` as `cursor` to load the
        next (older) page.
      operationId: listUsageSnapshots
      parameters:
        - schema:
            type: string
            format: uuid
            description: >-
              The usage base id (row id from /usage/bases, not the Airtable base
              id).
            example: 8f1d6b2c-3a4e-4c5d-9e6f-0a1b2c3d4e5f
          required: true
          description: >-
            The usage base id (row id from /usage/bases, not the Airtable base
            id).
          name: id
          in: path
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          required: false
          name: from
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          required: false
          name: to
          in: query
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          required: false
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 365
            default: 30
          required: false
          name: limit
          in: query
      responses:
        '200':
          description: A page of daily snapshots.
          content:
            application/json:
              schema:
                type: object
                properties:
                  baseId:
                    type: string
                  days:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                        tables:
                          type: array
                          items:
                            type: object
                            properties:
                              tableId:
                                type: string
                              tableName:
                                type: string
                              recordCount:
                                type: integer
                              storageBytes:
                                type: number
                              fileCount:
                                type: integer
                            required:
                              - tableId
                              - tableName
                              - recordCount
                              - storageBytes
                              - fileCount
                            additionalProperties: false
                        totals:
                          type: object
                          properties:
                            recordCount:
                              type: integer
                            storageBytes:
                              type: number
                            fileCount:
                              type: integer
                            tableCount:
                              type: integer
                          required:
                            - recordCount
                            - storageBytes
                            - fileCount
                            - tableCount
                          additionalProperties: false
                      required:
                        - date
                        - tables
                        - totals
                      additionalProperties: false
                  nextCursor:
                    type: string
                    nullable: true
                required:
                  - baseId
                  - days
                  - nextCursor
                additionalProperties: false
        '400':
          description: Bad request due to invalid input.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized, authentication token is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Usage base not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
        - message
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: sk_...
      description: >-
        Your Simplified Webhooks API key, sent as a bearer token:
        `Authorization: Bearer sk_...`. Create API keys in your [profile
        settings](https://www.simplified-webhooks.com/profile-settings).

````