> ## 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.

# See what a proactive task did this period

> This period's runs of a task, one for each account it was about, and for a book task the accounts it hasn't covered yet. Each list holds at most 200, with the true counts beside it.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/tasks/{task_id}/coverage
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/digital_workers/{worker_id}/tasks/{task_id}/coverage:
    get:
      tags:
        - digital_workers
      summary: See what a proactive task did this period
      description: >-
        This period's runs of a task, one for each account it was about, and for
        a book task the accounts it hasn't covered yet. Each list holds at most
        200, with the true counts beside it.
      operationId: digital_workers_task_coverage
      parameters:
        - description: The worker's id, from GET /v1/digital_workers
          in: path
          name: worker_id
          required: true
          schema:
            type: string
        - description: The task's id, from GET /v1/digital_workers/{worker_id}/tasks
          in: path
          name: task_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCoverage'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    TaskCoverage:
      properties:
        book_size:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            How many accounts a book task covers this period, after its
            conditions; null for a task that isn't a book task, or when the
            worker's accounts can't be read
          title: Book Size
        pending:
          anyOf:
            - items:
                $ref: '#/components/schemas/CoveredAccount'
              type: array
            - type: 'null'
          description: The accounts it hasn't covered yet; at most 200
          title: Pending
        pending_count:
          anyOf:
            - type: integer
            - type: 'null'
          description: How many of those it hasn't covered yet this period
          title: Pending Count
        period:
          description: >-
            The period this covers: `once` for a task each account gets once,
            else the run's start (a recurring task's scheduled time, a book
            goal's day), ISO 8601 UTC
          title: Period
          type: string
        runs:
          description: What it did this period, oldest first; at most 200
          items:
            $ref: '#/components/schemas/TaskRun'
          title: Runs
          type: array
        runs_total:
          title: Runs Total
          type: integer
        scope:
          description: >-
            global is about your workspace and no one account; account is about
            the account in `account_id`; book is about each account the worker
            covers (its `accounts.segment`), once each period, narrowed by
            `conditions`
          enum:
            - global
            - account
            - book
          title: Scope
          type: string
      required:
        - period
        - scope
        - runs
        - runs_total
        - book_size
        - pending_count
        - pending
      title: TaskCoverage
      type: object
    CoveredAccount:
      properties:
        id:
          description: The account's id, from GET /v1/objects/account/records
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
      required:
        - id
        - name
      title: CoveredAccount
      type: object
    TaskRun:
      properties:
        account:
          anyOf:
            - $ref: '#/components/schemas/CoveredAccount'
            - type: 'null'
          description: The account it was about; null for a run about no account
        completed_at:
          description: ISO 8601 UTC
          title: Completed At
          type: string
        detail:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Detail
        outcome:
          description: >-
            sent (it wrote to the customer), held (it left a message for a
            person to review), no_action (it judged nothing was needed: `detail`
            says why), goal_achieved, blocked (the goal can't be met: `detail`
            says why) or attempted (it ran without reporting an outcome)
          enum:
            - sent
            - held
            - no_action
            - goal_achieved
            - blocked
            - attempted
          title: Outcome
          type: string
        reported_by:
          description: >-
            agent (the worker reported it) or executor (Statisfy recorded a run
            the worker reported nothing for)
          enum:
            - agent
            - executor
          title: Reported By
          type: string
        run_id:
          title: Run Id
          type: string
      required:
        - account
        - run_id
        - outcome
        - reported_by
        - detail
        - completed_at
      title: TaskRun
      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.