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

# List account health

> Pages through account health: the AI's assessment of each account, per pillar (overallHealth and its six dimensions), the overrides people made, and manual health entries (pillar manual), with the labels, reasons and confidence the app shows. Read only: the AI writes health on your workspace's health schedule (weekly by default), and people write it in the app. Rows come by account, then pillar, then newest first; an account and pillar can have several rows on one day. By default every assessment is listed (the history); `latest=true` lists each account and pillar's current health, and `as_of=YYYY-MM-DD` its health on that day (its latest assessment by the day's end, UTC). Filter with `filter[<key>][<op>]=<value>` (conditions are ANDed; `in` repeats the parameter, up to 100 values): `account` and `pillar` (eq, in), each taking one condition, and, on the history only, `date` (eq, gt, gte, lt, lte: YYYY-MM-DD, as whole UTC days), which takes several. `limit` is up to 1000. Labels follow your current health scale, past rows included; level is the stable 7-point rating. A revert of an override is a new ai row dated when it was reverted, and the AI assessment an override replaced is the row before it. Manual entries can be edited or deleted in the app. Who made a manual entry, an override or a revert, and why they overrode, are not listed; neither are deleted accounts.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/health
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/health:
    get:
      tags:
        - health
      summary: List account health
      description: >-
        Pages through account health: the AI's assessment of each account, per
        pillar (overallHealth and its six dimensions), the overrides people
        made, and manual health entries (pillar manual), with the labels,
        reasons and confidence the app shows. Read only: the AI writes health on
        your workspace's health schedule (weekly by default), and people write
        it in the app. Rows come by account, then pillar, then newest first; an
        account and pillar can have several rows on one day. By default every
        assessment is listed (the history); `latest=true` lists each account and
        pillar's current health, and `as_of=YYYY-MM-DD` its health on that day
        (its latest assessment by the day's end, UTC). Filter with
        `filter[<key>][<op>]=<value>` (conditions are ANDed; `in` repeats the
        parameter, up to 100 values): `account` and `pillar` (eq, in), each
        taking one condition, and, on the history only, `date` (eq, gt, gte, lt,
        lte: YYYY-MM-DD, as whole UTC days), which takes several. `limit` is up
        to 1000. Labels follow your current health scale, past rows included;
        level is the stable 7-point rating. A revert of an override is a new ai
        row dated when it was reverted, and the AI assessment an override
        replaced is the row before it. Manual entries can be edited or deleted
        in the app. Who made a manual entry, an override or a revert, and why
        they overrode, are not listed; neither are deleted accounts.
      operationId: health_list
      parameters:
        - description: Only each account and pillar's current health
          in: query
          name: latest
          required: false
          schema:
            default: false
            type: boolean
        - description: >-
            Each account and pillar's health on this day (YYYY-MM-DD): its
            latest row by the day's end, UTC
          in: query
          name: as_of
          required: false
          schema:
            anyOf:
              - format: date
                type: string
              - type: 'null'
            default: null
        - in: query
          name: limit
          required: false
          schema:
            default: 100
            maximum: 1000
            minimum: 1
            type: integer
        - description: '`next_cursor` from the previous page'
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthPage'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    HealthPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Health'
          title: Data
          type: array
        has_more:
          default: false
          title: Has More
          type: boolean
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      required:
        - data
      title: HealthPage
      type: object
    Health:
      properties:
        account:
          description: The Statisfy account id
          title: Account
          type: string
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            The AI's confidence, from 0 to 1 (0 when it had too little data); 1
            on a manual entry or override
          title: Confidence
        date:
          description: >-
            When the row was written: the AI's assessment, a person's entry or
            override, or a revert
          format: date-time
          title: Date
          type: string
        health:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            As the app shows it: your health scale's label (such as Green), or
            the 7-point value when you have no scale; null when the AI had too
            little data. Labels follow your current scale: when it changes, past
            rows are relabelled too, so compare over time with level
          title: Health
        id:
          title: Id
          type: string
        level:
          anyOf:
            - enum:
                - Very Positive
                - Positive
                - Slightly Positive
                - Neutral
                - Slightly Negative
                - Negative
                - Very Negative
              type: string
            - type: 'null'
          description: >-
            The 7-point rating, from Very Negative to Very Positive (the label
            is derived from it; on an entry or override made with one of your
            scale's labels, that label's default rating). Null when the AI had
            too little data, or on older rows stored with another value
          title: Level
        locked_until:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            On an override, the end of the grace period the person chose: the AI
            does not reassess the pillar before then unless the override is
            reverted or replaced. Older override rows keep the value they were
            written with; null on other rows
          title: Locked Until
        pillar:
          description: >-
            overallHealth (the AI's overall assessment, weighing the six
            dimensions and the latest manual entry), one of the six dimensions,
            or manual (a manual health entry)
          enum:
            - overallHealth
            - productUsage
            - relationship
            - outcomes
            - experience
            - featureRequests
            - risks
            - manual
          title: Pillar
          type: string
        reason:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Why: the AI's reasoning (it may contain citation markers such as
            [1]), or what a person wrote with their manual entry or override (on
            an override, their reason for the new health). Where the AI had too
            little data: Insufficient data to predict health
          title: Reason
        source:
          description: >-
            ai (the AI's assessment, or a revert restoring it), manual (a manual
            entry), or overridden (a person replaced the AI's assessment)
          enum:
            - ai
            - manual
            - overridden
          title: Source
          type: string
      required:
        - id
        - account
        - pillar
        - health
        - level
        - confidence
        - reason
        - source
        - locked_until
        - date
      title: Health
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

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