---
name: brand-metadata
type: instructions
description: Fetch curated metadata for a tracked brand (display name, category, AI-authored characterisation, count of active phishings).
---

# Look up brand metadata

## Purpose
Given a brand slug, retrieve the human-friendly display name, the category the brand
falls under, the primary domain it represents, an AI-authored sentence on why
phishers target it, and the current count of active phishings.

## Endpoint
```
GET https://phishunt.io/api/v1/brands/<slug>.json
```

## Parameters
- `<slug>` - lowercase brand slug (path parameter). Examples: `amazon`, `binance`, `paypal`, `microsoft`. See https://phishunt.io/api/ for the valid list.

## Example
```bash
curl -sf https://phishunt.io/api/v1/brands/amazon.json | jq '{slug, name, category, notes, active_phishings}'
```

## Errors
- HTTP 404 with `{"error": "Unknown brand slug: ..."}` if the slug is not in COMPANIES.