---
title: "Get dependents of an IDS by range"
method: GET
path: "/v1/artifacts/ids/{namespace}/{slug}/dependents"
tags: ["ids"]
---

# Get dependents of an IDS by range

`GET /v1/artifacts/ids/{namespace}/{slug}/dependents`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/artifacts/ids/{namespace}/{slug}/dependents`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

Returns artifacts that depend on this IDS name within a version range

## Path parameters

- `namespace` string, required
- `slug` string, required

## Query parameters

- `match` string
- `mode` 'subset' | 'superset' | 'intersection'
- `rel` 'input' | 'output' | 'effect'
- `latest_only` boolean

## Response `200`

Successfully fetched Dependents

- Dependents
  - `dependents` Key[], required
    - `type` string, required
    - `namespace` string, required
    - `slug` string, required
    - `version` string, required

## Other responses

- `404`: Not found or not visible to user

---

[API](https://skmtc.dev/tetrascience/apis/artifact-management-service.md) - [All operations](https://skmtc.dev/tetrascience/apis/artifact-management-service/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/artifact-management-service/revisions/b96707d992f5?raw)