Quickstart

Receive a partner key and list brands

This quickstart makes the first authenticated Partner API call: list visible catalog brands.

The x-api-key is provisioned by Lomadee. If you do not have a key yet, contact your integration owner.

Before you begin

• A partner key in the format lmd_{env}_{prefix}_{secret}
• Scope brands:read (new keys include it)
• curl or any HTTP client

Step 1 — Confirm the header

Every Partner API route requires:

x-api-key: lmd_prod_xxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

An affiliate key on these routes returns 401. A wrong key type is not the same as a missing scope (403).

Step 2 — List brands

curl -X GET "https://api.lomadee.com.br/api/partner/brands?page=1&limit=10" \
  -H "x-api-key: $LOMADEE_PARTNER_API_KEY"

The response is { data, meta }. Each item has catalog fields (name, logo, network, rating) without channels, short URLs, or affiliate commission.

Step 3 — Filter offers

curl -X GET "https://api.lomadee.com.br/api/partner/campaigns?types=Offer&page=1&limit=10" \
  -H "x-api-key: $LOMADEE_PARTNER_API_KEY"

Generic coupons use types=GenericCoupon. PersonalCoupon codes are not included in the partner payload.

Next

• Authenticate
• List offers and coupons