Get Manufacturer Content

GET https://ecosystem.seam.co/v1/manufacturer_content/get

Returns everything Seam publishes about one manufacturer in one response:

manufacturer: your profile, with name, description, website, support contacts, and logos.
device_models: your published device models, with images, variants, device type, providers, and capabilities per provider.
providers: the providers (cloud services and systems) that connect your devices to Seam, with the support level of each integration.
compatibility: for each device category you make, the apps that support your devices through Seam.

The endpoint also accepts POST with the same parameters as a JSON body.

Examples

With a manufacturer secret key, your brand is implied:

curl --compressed \
  -H "Authorization: Bearer eco_sk_your_secret_key" \
  "https://ecosystem.seam.co/v1/manufacturer_content/get"

Without a key, or with a key that is not a manufacturer key, name the manufacturer:

curl --compressed -G \
  "https://ecosystem.seam.co/v1/manufacturer_content/get" \
  -d manufacturer_slug=schlage \
  -d locale=fr \
  -d limit=100

Parameters

Parameter	Type	Default	Description
`manufacturer_slug`	string	Your manufacturer key’s brand	The manufacturer, for example `schlage`. Required unless you use a manufacturer key. With a manufacturer key, any other slug fails with `403 manufacturer_mismatch`.
`locale`	string	`en`	The language for capability reports: `en` or `fr`. Unknown values fall back to `en`.
`include`	string[]	—	Extra device model data. `commerce` adds shop and marketplace listings, ASINs, and GTINs.
`include_forbidden`	boolean	`false`	Include your own device models that are hidden from third parties. Takes effect only with your manufacturer secret key. See Hidden Device Models.
`limit`	number	`500`	The number of device models per page, from 1 to 500.
`page_cursor`	string	—	The `pagination.next_page_cursor` from the previous page.

Response

{
  "manufacturer_content": {
    "manufacturer": {
      "manufacturer_id": "ef6bd59f-19aa-415a-8d12-9684eb227d8a",
      "slug": "schlage",
      "display_name": "Schlage",
      "website": "https://www.schlage.com",
      "description_md": "…",
      "logos": [
        {
          "kind": "square_logo",
          "url": "https://seam-ecosystem-media.fly.storage.tigris.dev/…/square_logo.png",
          "mime": "image/png",
          "width": 512,
          "height": 512
        }
      ],
      "device_model_count": 17
    },
    "providers": [
      {
        "slug": "schlage",
        "display_name": "Schlage Home",
        "integrations": [
          {
            "kind": "access",
            "feature": "lock_unlock",
            "integration_support_level": "stable",
            "flags": { "can_remotely_lock": true, "can_remotely_unlock": true }
          }
        ],
        "device_model_count": 3
      }
    ],
    "compatibility": [
      {
        "device_category": "smartlock",
        "partners": [
          {
            "slug": "example-app",
            "display_name": "Example App",
            "website": "https://www.example.com",
            "industries": [
              { "slug": "short-term-rental", "display_name": "Short-Term Rental" }
            ],
            "support": {
              "supported": true,
              "resolved_level": "manufacturer",
              "declared_status": "enabled",
              "note": null
            }
          }
        ]
      }
    ],
    "device_models": [
      {
        "slug": "camelot-trim-connected-keypad-deadbolt",
        "display_name": "Camelot Trim Connected Keypad Deadbolt",
        "product_url": "https://www.schlage.com/en/home/products/BE369NXCAMFFF.html",
        "device_type": { "slug": "smartlock", "display_name": "Smartlock" },
        "featured_image": { "url": "https://seam-ecosystem-media.fly.storage.tigris.dev/…" },
        "variants": [
          {
            "color_name": "Satin Nickel",
            "style_name": "Camelot Trim",
            "manufacturer_model_id": "BE369NX CAM 619",
            "images": []
          }
        ],
        "providers": [
          { "slug": "schlage-engage", "display_name": "Schlage Engage" }
        ],
        "capabilities_by_provider": [
          {
            "provider": { "slug": "schlage-engage", "display_name": "Schlage Engage" },
            "capabilities": [
              {
                "name": "can_remotely_unlock",
                "supported": "yes",
                "integration_support_level": "stable",
                "report": null
              }
            ]
          }
        ]
      }
    ],
    "pagination": {
      "has_next_page": true,
      "next_page_cursor": "camelot-trim-connected-keypad-deadbolt"
    },
    "locale": "en"
  },
  "ok": true
}

This example is trimmed. Objects include more fields than shown, such as IDs and timestamps.

`manufacturer`

Your manufacturer profile: slug, display_name, website, description_md, headquarters, country_of_origin, parent_org, customer support contacts (customer_support_phone, customer_support_email, customer_support_url), logos (square and horizontal, in color and monochrome), and default_device_images (a fallback image for each device type). device_model_count counts the device models the caller can see. It includes your hidden models only when they are included in the response.

`providers`

The providers that connect your devices to Seam: those linked to your brand and those linked to any of your device models. Each provider includes:

integrations: what Seam supports through this provider. Each integration has a kind (access, climate, or sensor), a feature (for example lock_unlock), an integration_support_level (stable, beta, in-progress, planned, inquire, or unavailable), and flags with the capabilities it provides.
device_model_count: how many of your device models the provider covers. A provider linked only to your brand has 0.
logos, industries, is_acs (whether it is an access control system), and requirements_md (integration requirements, when recorded).

`compatibility`

One entry for each device category you make, such as smartlock or thermostat. Each entry lists the partners (apps) that support your devices in that category through Seam, the same apps that Compatible Apps shows. An app appears only where Seam or the app’s maker has declared support. Each partner includes its profile (slug, display_name, website, description_md, industries, solutions, and logos in assets) and a support object:

supported: always true in this list.
resolved_level: the most specific level the deciding declaration was made at: device_category, manufacturer, provider, or capability.
declared_status: the deciding declaration.
note: the app’s note about its support, when it has one.

`device_models`

Your published device models, ordered by slug, in the device model summary shape.

`pagination` and `locale`

Only device_models is paged. Every other field is the same on every page, so you can read them from the first page. When pagination.has_next_page is true, pass pagination.next_page_cursor as page_cursor to get the next page. locale is the language capability reports were resolved in, after any fallback.

Errors

Status	`error.type`	Cause
400	`manufacturer_slug_required`	No `manufacturer_slug`, and the key (if any) is not a manufacturer key.
403	`manufacturer_mismatch`	Your manufacturer key named a different manufacturer.
404	`manufacturer_not_found`	No published manufacturer has this slug.

See the overview for key, rate limit, and parameter errors.

Next Steps

Filter device models by type, provider, or capability with List Device Model Summaries.
Get your keys in Keys and Authentication.

Getting Started

Use Cases

Core Concepts

Capability Guides

UI Components

Developer Tools

Industry Guides

Device Manufacturer Guidance

Low-Level APIs

Get Manufacturer Content

Examples

Parameters

Response

`manufacturer`

`providers`

`compatibility`

`device_models`

Errors

Next Steps

​Examples

​Parameters

​Response

​manufacturer

​providers

​compatibility

​device_models

​pagination and locale

​Errors

​Next Steps

Examples

Parameters

Response

`manufacturer`

`providers`

`compatibility`

`device_models`

`pagination` and `locale`

Errors

Next Steps