GET /v1/merchants/{id} — get a specific merchant

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

string

required

Merchant identifier — accepts an integer ID, nmer_ ULID, mer_ canonical ULID, short slug, or a human-readable slug set in Merchant Manager.

integer

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:

Call GET /v1/merchants?search=merchant+name to find the merchant.
Copy the id or object_id from the matching result.
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

Integer ID

curl --request GET \
  'https://api.affiliate.com/v1/merchants/71655?extended=1' \
  --header 'Authorization: Bearer YOUR_API_KEY'

nmer_ ULID

curl --request GET \
  'https://api.affiliate.com/v1/merchants/nmer_01khfn7dzc2a1w09d2rrmg0vg2?extended=1' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Canonical ID

curl --request GET \
  'https://api.affiliate.com/v1/merchants/mer_01kkjwnhgctjrmh5mqkcpdhq84?extended=1' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "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": "<h2>Terms and Conditions</h2><p>Program terms as reported by the network — HTML, and often long.</p>"
          }
        },
        {
          "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 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

Account

Networks

Merchants

Products

Tools

Watches

Product Lists

Pools

Reports

GET /v1/merchants/{id} — get a specific merchant

Endpoint

Parameters

How to find a merchant’s ID

Example requests

Response

Response fields

Error responses

​Endpoint

​Parameters

​How to find a merchant’s ID

​Example requests

​Response

​Response fields

​Error responses

Endpoint

Parameters

How to find a merchant’s ID

Example requests

Response

Response fields

Error responses