---
title: "List artifacts"
method: GET
path: "/v1/artifacts"
---

# List artifacts

`GET /v1/artifacts`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/artifacts`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns persisted artifact records owned by the authenticated organization. Filter by stored `kind` or `status`; the response is a bounded list and does not promise a complete archive or an external-storage inventory.

## Query parameters

- `kind` string
- `status` string
- `limit` integer

## Response `200`

Organization-scoped artifact list with request correlation fields.

- ArtifactInventoryList
  - `object` 'list', required
  - `data` ArtifactInventory[], required
    - `object` 'artifact', required
    - `id` string, required
    - `createdAt` string, date-time, required
    - `livemode` boolean, required
    - `kind` string, required
    - `status` string, required
    - `downloadUrl` string, required
    - `storageMode` 'local' | 'r2', required
    - `objectKey` string, nullable, required
    - `manifest` ArtifactManifest, required
      - `object` 'artifact_manifest', required
      - `id` string, required
      - `artifactId` string, required
      - `kind` string, required
      - `status` string, required
      - `filename` string, required
      - `contentType` string, required
      - `storageMode` 'local' | 'r2', required
      - `objectKey` string, nullable, required
      - `byteLength` integer, required
      - `lineCount` integer, required
      - `checksumSha1` string, required
      - `filing` object, nullable, required
      - `section` object, nullable, required
      - `exportedFormats` string[], required
      - `createdAt` string, date-time, required
      - `entity` object, nullable
      - `links` object
      - `citation` object
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `queryPath` string, nullable, required
  - `queryPathReason` string, nullable, required
  - `policyYears` object, nullable, required
  - `degradedState` object, nullable, required
  - `requestId` string, required
  - `traceparent` string, required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)