# Vendors

## List

**get** `/v1/vendors`

List all vendors

### Returns

- `created_at: string`

  An ISO-8601-formatted timestamp representing when the vendor was created (UTC)

- `description: string`

  The vendor's description

- `name: string`

  The vendor's display name

- `urn: string`

  A unique identifier for the vendor

### Example

```http
curl https://developer.clarative.ai/v1/vendors \
    -H "Authorization: Bearer $CLARATIVE_API_KEY"
```

## Retrieve

**get** `/v1/vendors/{urn}`

Fetch in-depth information about a single vendor

### Path Parameters

- `urn: string`

### Returns

- `created_at: string`

  An ISO-8601-formatted timestamp representing when the vendor was created (UTC)

- `description: string`

  The vendor's description

- `name: string`

  The vendor's display name

- `urn: string`

  A unique identifier for the vendor

### Example

```http
curl https://developer.clarative.ai/v1/vendors/$URN \
    -H "Authorization: Bearer $CLARATIVE_API_KEY"
```