---
title: "List Growth Data Artifacts"
method: GET
path: "/api/data-artifacts"
tags: ["growth-artifact-jobs"]
---

# List Growth Data Artifacts

`GET /api/data-artifacts`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/data-artifacts`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Query parameters

- `offset` integer
- `limit` integer
- `tool_kind` string, nullable
- `capability_id` string, nullable
- `status` 'pending' | 'running' | 'completed' | 'failed', nullable

## Response `200`

Successful Response

- ListGrowthDataArtifactsResponse
  - `artifacts` GrowthDataArtifactSummaryResponse[], required
    - `artifact_id` string, required
    - `capability_id` string, nullable, required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, nullable, required
    - `job_id` string, nullable, required
    - `metadata` ArtifactPublicMetadata, required: Sanitized producer metadata. Keys vary by tool kind; secret and private storage-coordinate keys are removed recursively.
    - `row_count` integer, required
    - `schema` GrowthDataArtifactSchema, required: Versioned producer schema, including valid legacy empty and unversioned records.
      - `columns` GrowthDataArtifactColumnSchema[]: Ordered declarations for known artifact row columns.
        - `name` string, required: Exact artifact row column name.
        - `schema` AiAnalysisOutputPropertySchemaOutput: Known JSON Schema keywords plus recursive caller extension keywords.
          - `description` string: Caller-provided meaning of this generated result field.
          - `enum` ArtifactJsonValueOutput[]: Exact finite set of allowed JSON values, which may be empty.
            - union: A recursive JSON value; numbers must be finite.
              - …
          - `type` union: Allowed JSON value type or nonempty union of value types.
            - 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string': JSON value category accepted by a generated result field.
            - AiAnalysisJsonSchemaType[]
        - `type` string: Producer-declared logical value type.
      - `output_schema` AiAnalysisOutputSchemaOutput: Caller-owned JSON Schema for the fields generated on every result row.
        - `additionalProperties` false: AI analysis never permits undeclared generated fields.
        - `properties` AiAnalysisOutputPropertiesOutput, required: One to twenty-five caller-defined result fields.
        - `required` string[]: Caller-defined fields the model must always return.
        - `type` 'object', required: Required object root.
      - `source` string, nullable: Producer family that declared this schema, when supplied.
      - `version` 1: Artifact schema format version.
    - `status` 'pending' | 'running' | 'completed' | 'failed', required
    - `tool_kind` string, required
    - `updated_at` string, date-time, required
    - `workflow_run_id` string, nullable, required
  - `limit` integer, required
  - `next_offset` integer, nullable, required
  - `offset` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)