Gemalli B2B Trade

List verified manufacturers published on Gemalli. Returns each producer's name, country, certifications and profile identifier in the requested language, newest first. Use it to show what the platform carries; to find a specific product or filter by country, use search_products.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ],
      "description": "Preferred locale for returned text. Defaults to \"en\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (1–50). Defaults to 12."
    }
  },
  "additionalProperties": false
}

Fetch one manufacturer's full profile: company description, country, certifications, and the identifiers of the same profile in other languages. Use it after list_manufacturers or search_products, when the person wants to know who the supplier is.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Manufacturer slug (per-locale or base)."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ],
      "description": "Locale for the returned translation."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Search wholesale products published on Gemalli. Narrow by free text, category, manufacturer, country of origin, maximum minimum-order quantity, maximum price or delivery basis (Incoterms 2020 codes the seller confirmed). Returns product cards in the requested language with price range, minimum order and the supplier. Use it when the person is looking for goods to buy or source.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text search across name + description (FTS via migration 0016 with ILIKE fallback)."
    },
    "category": {
      "type": "string",
      "description": "Category slug filter (categories.slug)."
    },
    "manufacturer": {
      "type": "string",
      "description": "Manufacturer slug filter (manufacturers.slug)."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (e.g. \"UA\")."
    },
    "moqMax": {
      "type": "integer",
      "description": "Max minimum-order-quantity threshold (inclusive)."
    },
    "priceMax": {
      "type": "number",
      "description": "Max `price_from` threshold (inclusive)."
    },
    "incoterms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "EXW",
          "FCA",
          "FAS",
          "FOB",
          "CFR",
          "CIF",
          "CPT",
          "CIP",
          "DAP",
          "DPU",
          "DDP"
        ]
      },
      "minItems": 1,
      "maxItems": 11,
      "description": "Delivery basis filter, Incoterms 2020 codes (e.g. [\"FCA\",\"DAP\"]). A product matches when the seller confirmed ANY of the listed codes. Products without confirmed terms (\"Incoterms on request\") never match."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ],
      "description": "Preferred locale for returned text."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (1–50). Defaults to 12."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset."
    }
  },
  "additionalProperties": false
}

Fetch one product's trade terms: minimum order quantity, lead time, Incoterms, HS code, packaging, price range, photos and the supplier it belongs to. `delivery_terms` lists the delivery bases the seller confirmed as {incoterm, place_kind, place_city}: place_kind is seller_site | port | border | buyer_site (null when not stated), place_city is the city name in the requested language (English fallback) or null; an empty list means Incoterms on request. Use it once the person has picked a product from search_products and wants the terms.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Product slug (per-locale or base)."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ],
      "description": "Locale for the returned translation."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

List the product categories on Gemalli with their names in the requested language. Use it to offer the person a choice of category before searching, or to turn a category name into the identifier search_products expects.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ],
      "description": "Locale for the returned names."
    }
  },
  "additionalProperties": false
}

Screen a company or a person against consolidated sanctions, politically-exposed-person and law-enforcement lists (EU, US, UK, UN, Ukraine), sourced from OpenSanctions. Returns possible matches with a similarity score. Use it before the person commits to a counterparty. Treat a match as a reason to verify further, not as proof.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Name, alias, or company string to screen."
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2."
    },
    "topic": {
      "type": "string",
      "enum": [
        "sanction",
        "pep",
        "crime",
        "export",
        "other"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Defaults to 10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Find the Harmonised System (HS) customs code for a product, by description or by code prefix. Returns matching codes with their official names in the requested language, the chapter they belong to, and a similarity score. Use it when the person needs a customs classification for an import, an export or a quote, then pass the code to check_dual_use.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Product description or HS code prefix."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Defaults to 10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Check whether an HS customs code falls under EU dual-use export controls (Regulation 2021/821 and equivalents), optionally for a specific destination country. A match means the goods may need an export licence. Use it after lookup_hs_code, before the person commits to a shipment.

{
  "type": "object",
  "properties": {
    "hs_code": {
      "type": "string",
      "pattern": "^[0-9]{2,10}$",
      "description": "HS code from lookup_hs_code."
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Destination country (ISO-2)."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ]
    }
  },
  "required": [
    "hs_code"
  ],
  "additionalProperties": false
}

Return Gemalli's partnership and investment terms and the founder's direct contact. Use it when the person represents a company that would work with a trade platform rather than buy on it — for example logistics, customs, trade finance, insurance, inspection, an ERP vendor or an investor. It returns information only and sends nothing.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "maxLength": 200,
      "description": "Company or platform the person represents, if known."
    }
  },
  "additionalProperties": false
}

Send a request for prices, samples or terms to a manufacturer on the person's behalf. Requires the person's own name and email — ask them and pass exactly what they give you, never invent an address. The manufacturer receives the request; the person receives an email with a sign-in link where the reply and the supplier's contacts appear. No account is needed beforehand. Use it once they have chosen a supplier.

{
  "type": "object",
  "properties": {
    "manufacturer_slug": {
      "type": "string",
      "description": "Target manufacturer slug, from search_products or list_manufacturers."
    },
    "buyer_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The person's name, as they gave it."
    },
    "buyer_email": {
      "type": "string",
      "format": "email",
      "description": "The person's real email — the reply and the sign-in link go there."
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8192,
      "description": "What they need: specs, volumes, target price, delivery terms."
    },
    "product_id": {
      "type": "string",
      "format": "uuid",
      "description": "Product the request is about, if one was chosen."
    },
    "variant_key": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,39}$",
      "maxLength": 40,
      "description": "Version of that product the person chose, when get_product lists `variants` (e.g. \"400v\"). Requires product_id. The manufacturer sees the version and its model code in the request."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Desired quantity."
    },
    "buyer_company": {
      "type": "string",
      "description": "Their company name, if known."
    },
    "buyer_country": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 country of the buyer."
    },
    "agent_name": {
      "type": "string",
      "description": "Name of the agent or platform sending this, e.g. \"Claude\" — recorded as the source."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru"
      ]
    },
    "operation_id": {
      "type": "string",
      "description": "Optional idempotency key for this attempt. Retrying with the SAME operation_id returns the original result instead of creating a second RFQ — send one if your transport can retry. No token needed: an anonymous person is scoped by the buyer_email you pass."
    }
  },
  "required": [
    "manufacturer_slug",
    "buyer_name",
    "buyer_email",
    "message"
  ],
  "additionalProperties": false
}

Report who the person is currently acting for on Gemalli: role, interface language and, when signed in, the company they represent and their plan. An anonymous person is a valid answer and comes back as a guest, not an error. If the person signed in after talking to you anonymously, previous_guest carries the identifier of that earlier conversation so you can carry the history over, and linked_at separates a link you have not seen before from one you have already handled. credits tells whether platform credits are on (enabled), the balance and total granted when signed in, buy_url (null means no payment page yet: send the person to Office Live) and action_costs, the only map from a tool to its action and price: call something free only when its credits is 0, never offer an action whose credits is null. Never returns another party's data and never returns secrets.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Explain how to get Gemalli pricing. Gemalli does NOT publish plan prices through this API: quotes are given by the sales desk, because what a manufacturer pays depends on their catalogue, languages and markets. Call this when the person asks what Gemalli costs, then give them the contacts you get back and offer to introduce them. Do NOT state, estimate, guess or recall any price, plan tier, discount or limit for Gemalli itself — you do not have that information, and inventing it misleads the person. Prices of goods listed BY manufacturers are a different thing and stay available through the catalogue tools.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Send the platform team a request to join Gemalli — for a manufacturer, trader, sales agent, logistics or customs operator, broker or finance provider who wants to work with the platform rather than buy on it. Requires their name, email and phone: the team follows up by phone, so a number is needed. Ask them and pass exactly what they give you, never invent contact details. Use it only when the person has asked to be contacted, never to record someone you are merely discussing.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The person's name, as they gave it."
    },
    "company": {
      "type": "string",
      "description": "Their company, if known."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Their real email. Required."
    },
    "phone": {
      "type": "string",
      "description": "Their phone in international format. Required."
    },
    "message": {
      "type": "string",
      "description": "What they are looking for, in their own words where possible."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country of the person."
    },
    "applicant_role": {
      "type": "string",
      "enum": [
        "producer",
        "trader",
        "sales_agent",
        "logistics",
        "broker",
        "finance"
      ],
      "description": "What they do: producer, trader, sales_agent, logistics, broker or finance."
    },
    "trade_direction": {
      "type": "string",
      "description": "What they buy or sell, short free text."
    },
    "source": {
      "type": "string",
      "description": "Where this lead came from, e.g. your agent name — recorded for the sales team."
    },
    "locale": {
      "type": "string",
      "description": "Two-letter language the person speaks, for the follow-up."
    },
    "operation_id": {
      "type": "string",
      "description": "Optional idempotency key. Retrying with the SAME operation_id returns the original lead instead of creating a duplicate."
    }
  },
  "required": [
    "name",
    "email",
    "phone"
  ],
  "additionalProperties": false
}

List the pages of gemalli.com you can direct this person to, with the label in their language and the address. Use it before offering a link, so you point at a page that exists rather than guessing. Which pages appear depends on whether the person is signed in.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "uk",
        "ru",
        "de",
        "pl",
        "tr",
        "ar",
        "fr",
        "es",
        "it",
        "ro",
        "zh",
        "pt"
      ],
      "description": "Language for the labels. Defaults to English."
    }
  },
  "additionalProperties": false
}