> ## Documentation Index
> Fetch the complete documentation index at: https://guides.affiliate.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GET /v1/merchants/{id} — get a specific merchant
> Fetch a single merchant by numeric ID, nmer_ ULID, mer_ canonical ID, or slug. Returns the full merchant object including per-provider links and your standing, and the canonical record.
The `GET /v1/merchants/{id}` endpoint returns the full profile for a single merchant. The `{id}` path parameter accepts several formats:
| Format | Example | Resolves to |
| --------------------- | --------------------------------- | ------------------------- |
| Integer | `71655` | Network merchant (legacy) |
| `nmer_` ULID | `nmer_01khfn7dzc2a1w09d2rrmg0vg2` | Network merchant |
| `mer_` ULID | `mer_01kkjwnhgctjrmh5mqkcpdhq84` | Canonical merchant |
| Slug | `nmer_rrmg0vg2` | Network merchant |
| Merchant Manager slug | `100-pure` | Canonical merchant |
## Endpoint
```
GET /v1/merchants/{id}
```
## Parameters
Merchant identifier — accepts an integer ID, `nmer_` ULID, `mer_` canonical ULID, short slug, or a human-readable slug set in Merchant Manager.
Set to `1` to return the extended merchant object — `providers`, `canonical`, `categories`, `countries`, `currencies`, `supports`, `supports_deeplinking`, `cookie_duration`, `home_url`, `object_id`, and `slug`. Use the integer `1`, not `true`.
**Pass `extended=1` on every request.** Whether the extended fields come back by default depends on your account, so don't assume they will. It's harmless if your account already returns them. If the response is missing `providers` or commissionable links, add the flag.
## How to find a merchant's ID
If you don't already have a merchant's ID, use the list or search endpoint first:
1. Call `GET /v1/merchants?search=merchant+name` to find the merchant.
2. Copy the `id` or `object_id` from the matching result.
3. Use that value in `GET /v1/merchants/{id}` for direct lookups.
Store `object_id` (`nmer_` format) rather than the integer `id` — it is stable across system migrations.
## Example requests
```bash Integer ID theme={null}
curl --request GET \
'https://api.affiliate.com/v1/merchants/71655?extended=1' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
```bash nmer_ ULID theme={null}
curl --request GET \
'https://api.affiliate.com/v1/merchants/nmer_01khfn7dzc2a1w09d2rrmg0vg2?extended=1' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
```bash Canonical ID theme={null}
curl --request GET \
'https://api.affiliate.com/v1/merchants/mer_01kkjwnhgctjrmh5mqkcpdhq84?extended=1' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
## Response
```json theme={null}
{
"data": [
{
"id": 142666,
"object_id": "nmer_01khfn7dzc2a1w09d2rrmg0vg2",
"slug": "nmer_rrmg0vg2",
"origin_id": "37229",
"name": "100% PURE",
"description": "100% PURE creates natural, high-performance skincare and makeup with safe, pure ingredients.",
"domains": ["https://100percentpure.com", "https://www.100percentpure.com"],
"home_url": "https://100percentpure.com",
"icon_url": "https://img.affiliate.com/logos/canonical_merchants/01kkjwnhgctjrmh5mqkcpdhq84/icon.png",
"logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkjwnhgctjrmh5mqkcpdhq84/logo.png",
"product_count": 689,
"promotion_count": 0,
"cookie_duration": null,
"supports_deeplinking": true,
"categories": [],
"countries": ["US"],
"currencies": [],
"supports": { "products": true, "services": false, "promotions": false },
"providers": [
{
"provider": "network",
"status": "approved",
"status_changed_at": "2026-03-12T07:13:10+00:00",
"credential_id": "01kkgc7y12s1r29nkhrxavxbs8",
"url": "https://100pure.sjv.io/c/21786/3053058/37229",
"template": "https://100pure.sjv.io/c/{AFF_ID}/3053058/37229",
"outclick": "https://outclick.co/a/2.NetworkOpaqueToken?affiliate_id={AFF_ID}&sub_id={SUB_ID}",
"supports_deeplinking": true,
"deeplink": null,
"approval": {
"commission_data": {
"action_name": "Default Sale",
"action_type": "advanced sale",
"commission_default": "8.00%"
},
"epc_data": {
"currency": "USD",
"seven_day": "5.10",
"three_month": "13.70"
},
"cookie_duration": "P1M2D",
"start_date": "2025-06-24",
"end_date": null,
"terms_and_conditions": "Terms and Conditions
Program terms as reported by the network — HTML, and often long.
"
}
},
{
"provider": "shopnomix",
"status": "approved",
"status_changed_at": "2026-03-18T14:02:55+00:00",
"credential_id": "01j8z3example000credential",
"url": "https://r.v2i8b.com/api/v1/bid/redirect?url=https%3A%2F%2F100percentpure.com&campaign_id=01J8Z3K9QW7RT2VN5XB6MC4FDH&source={SUB_ID}",
"template": "https://r.v2i8b.com/api/v1/bid/redirect?url=https%3A%2F%2F100percentpure.com&campaign_id={AFF_ID}&source={SUB_ID}",
"outclick": "https://outclick.co/a/2.ShopnomixOpaqueToken?affiliate_id={AFF_ID}&sub_id={SUB_ID}",
"supports_deeplinking": true,
"deeplink": {
"domain": "100percentpure.com",
"template": "https://r.v2i8b.com/api/v1/bid/redirect?url={target_url}&campaign_id=01J8Z3K9QW7RT2VN5XB6MC4FDH&source={SUB_ID}"
},
"approval": null
}
],
"network": {
"id": 335,
"slug": "rnet_hm7pn95t",
"name": "Impact",
"region": "US",
"url": "https://www.impact.com",
"logo_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
"icon_url": "https://img.affiliate.com/logos/groups/10020/64x64.png",
"canonical_id": "net_01kkgbymywvbf5qjdcdwchxdhm",
"links": {
"self": "https://api.affiliate.com/v1/networks/rnet_01kkgbyq82ve56ywbmhm7pn95t",
"canonical": "https://api.affiliate.com/v1/networks/net_01kkgbymywvbf5qjdcdwchxdhm"
}
},
"canonical": {
"id": "mer_01kkjwnhgctjrmh5mqkcpdhq84",
"slug": "mer_kcpdhq84",
"name": "100% PURE",
"site_url": "https://100percentpure.com",
"logo_url": "https://img.affiliate.com/logos/canonical_merchants/01kkjwnhgctjrmh5mqkcpdhq84/logo.png",
"icon_url": "https://img.affiliate.com/logos/canonical_merchants/01kkjwnhgctjrmh5mqkcpdhq84/icon.png",
"domains": { "100percentpure.com": "mer_01kkjwnhgctjrmh5mqkcpdhq84" },
"domain_canonical_id": null,
"links": {
"self": "https://api.affiliate.com/v1/merchants/mer_01kkjwnhgctjrmh5mqkcpdhq84",
"domain_canonical": null
}
},
"merchant_types": ["standard"],
"link_services": null
}
]
}
```
## Response fields
See [List Merchants — Response fields](/api-reference/merchants/list-merchants#response-fields) for the full field reference. The single-merchant response uses the same object shape.
## Error responses
| Status | Meaning |
| ------ | ---------------------------------------------------------------- |
| `400` | Invalid input — check that `id` is a valid format |
| `401` | Unauthenticated — include a valid `Authorization: Bearer` header |
| `404` | No merchant found with the given ID |
| `429` | Rate limit exceeded — slow down your request rate |