---
title: "Get artifact ids"
method: GET
path: "/api/v2/billing-insights/hierarchy-lookup/{level}"
tags: ["BillingInsights"]
---

# Get artifact ids

`GET /api/v2/billing-insights/hierarchy-lookup/{level}`

## Request

- Base URL: `https://billing-insights.api.relativity.one/billing-drilldown-api`
- URL: `https://billing-insights.api.relativity.one/billing-drilldown-api/api/v2/billing-insights/hierarchy-lookup/{level}`
- Auth: none required
- TypeScript: <https://skmtc.dev/relativity/apis/billing-insights-api/docs/api/v2/billing-insights/hierarchy-lookup/:level/get.ts> (a function with typed inputs; its response is checked against the schema)

Get artifact ids for workspace, matter, client, instance that can be used for filtering billing users and month details data.

## Path parameters

- `level` 'Workspace' | 'Matter' | 'Client' | 'Instance' | 'Contract', required

## Query parameters

- `instanceId` string
- `shouldUnhashData` boolean

## Response `200`

OK

- GetHierarchyLookupResponse
  - `results` GetHierarchyLookupResponseItem[], nullable
    - `name` string, nullable: Name of the item
    - `anonymization` string, nullable: Flag that identifies if the name is hashed. If the value is _Hashed_ then value of a _Name_ field is replaced with hash List of possible values: - Hashed - None
    - `anonymizedFields` object, nullable: Collection that holds what type of data is hashed.
    - `selector` HierarchyItemSelector: Specifies item to select. instanceID_ must be provided, additionally depending on the chosen level must be provided _clientArtifactID_, _matterArtifactID_ or _workspaceArtifactID
      - `contractID` string, nullable
      - `instanceID` string, nullable
      - `clientArtifactID` integer, nullable
      - `matterArtifactID` integer, nullable
      - `workspaceArtifactID` integer, nullable

---

[API](https://skmtc.dev/relativity/apis/billing-insights-api.md) - [All operations](https://skmtc.dev/relativity/apis/billing-insights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/relativity/apis/billing-insights-api/revisions/f6fa4175d8c9?raw)