---
title: "Get one artisan"
method: GET
path: "/api/artisans/{artisanId}"
tags: ["Catalogue"]
---

# Get one artisan

`GET /api/artisans/{artisanId}`

## Request

- Base URL: `https://vaanzari.com`
- URL: `https://vaanzari.com/api/artisans/{artisanId}`
- Auth: none required

Returns one public artisan profile and linked visible sarees.

## Path parameters

- `artisanId` string, required

## Response `200`

Artisan profile.

- Artisan
  - `id` string, required
  - `name` string, required
  - `location` string, nullable
  - `specialty` string, nullable
  - `lineage_text` string, nullable
  - `sarees` Saree[]
    - `id` string, required
    - `commerceChannelId` string, required: Immutable cross-channel catalogue and event matching ID.
    - `title` string, required
    - `price` number, required
    - `stock` integer, required
    - `image` string, uri, nullable
    - `fabric` string, nullable
    - `technique` string, nullable
    - `region` string, nullable
    - `occasion` string, nullable
    - `artisanId` string, nullable
    - `artisanName` string, nullable
    - `sku` string, nullable: Verified public SKU only; never an internal identifier.

## Other responses

- `404`: Structured API error.

---

[API](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api.md) · [All operations](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/revisions/1a8cc2dbe711?raw)