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

# get_enrich_status

> **Check analysis progress**

Report the progress of a worksheet column job started by enrich_worksheet, blocking until it settles or a fixed server-side wait cap passes.

`done: false` means the job is still running; its worksheetId and jobId are unchanged. `done` is true for `finished`, `failed` (with the worker's `error` when recorded), `timed_out` and `untracked`: no column carries the jobId, from a wrong id or cleaned-up tracking, so the outcome is unknown. A tool error means the status could not be read; it does not establish that the job finished or failed.

For a failed formula job, report the worker's `error` when recorded and leave the existing worksheet and column in place; do not create another worksheet or column, or start an enrichment.

`answerAggregates` counts only each column's most common values, so it cannot give a true min or max; `numericSummaries` holds exact full-column statistics. While the job runs, the top 5 `sampleValues` and top 10 counts per column are a rough preview. A finished result may omit breakdowns that did not fit the request time; that is not a failure.



## OpenAPI

````yaml /api-reference/tools-openapi.json post /v1/get_enrich_status
openapi: 3.1.0
info:
  title: Rippit API
  version: 1.0.0
  description: Every operation is also an MCP tool with the same name and parameters.
servers:
  - url: https://api.rippit.com
security:
  - bearer: []
paths:
  /v1/get_enrich_status:
    post:
      summary: get_enrich_status
      description: >-
        **Check analysis progress**


        Report the progress of a worksheet column job started by
        enrich_worksheet, blocking until it settles or a fixed server-side wait
        cap passes.


        `done: false` means the job is still running; its worksheetId and jobId
        are unchanged. `done` is true for `finished`, `failed` (with the
        worker's `error` when recorded), `timed_out` and `untracked`: no column
        carries the jobId, from a wrong id or cleaned-up tracking, so the
        outcome is unknown. A tool error means the status could not be read; it
        does not establish that the job finished or failed.


        For a failed formula job, report the worker's `error` when recorded and
        leave the existing worksheet and column in place; do not create another
        worksheet or column, or start an enrichment.


        `answerAggregates` counts only each column's most common values, so it
        cannot give a true min or max; `numericSummaries` holds exact
        full-column statistics. While the job runs, the top 5 `sampleValues` and
        top 10 counts per column are a rough preview. A finished result may omit
        breakdowns that did not fit the request time; that is not a failure.
      operationId: get_enrich_status
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                worksheetId:
                  type: string
                  minLength: 1
                  pattern: ^[A-Za-z0-9_-]+$
                  description: Worksheet the column job runs on.
                jobId:
                  type: string
                  minLength: 1
                  description: >-
                    Job id returned when the enrichment or formula computation
                    started.
                wait:
                  default: true
                  description: >-
                    True (default) blocks until the job settles or the wait cap
                    passes; false reads once.
                  type: boolean
              required:
                - worksheetId
                - jobId
                - wait
              additionalProperties: false
      responses:
        '200':
          description: Tool result.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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