curl --compressed \
-H "Authorization: Bearer eco_sk_your_secret_key" \
"https://ecosystem.seam.co/v1/manufacturer_content/get"
curl --compressed -G \
"https://ecosystem.seam.co/v1/manufacturer_content/get" \
-d manufacturer_slug=schlage \
-d locale=fr \
-d limit=100
{
"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
}
API Reference
Get Manufacturer Content
Returns everything Seam publishes about one manufacturer in one call: the profile (name, description, links, logos), its published device models in the summary shape with capabilities per provider, the providers that cover the brand with their integration support levels, and the live partner apps that support it in each device category (declared-first, like /compatibility, including support declared for a provider that serves the brand). With a manufacturer key (secret or embed), the manufacturer is implied and manufacturer_slug is optional; naming another manufacturer fails with 403 manufacturer_mismatch. Without one, name the manufacturer with manufacturer_slug. Device models hidden from third parties are excluded; with the manufacturer’s secret key, include_forbidden adds them. Device models are paged by slug with limit and page_cursor; every other field is the same on every page.
GET
/
manufacturer_content
/
get
curl --compressed \
-H "Authorization: Bearer eco_sk_your_secret_key" \
"https://ecosystem.seam.co/v1/manufacturer_content/get"
curl --compressed -G \
"https://ecosystem.seam.co/v1/manufacturer_content/get" \
-d manufacturer_slug=schlage \
-d locale=fr \
-d limit=100
{
"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
}
Use this endpoint to read your whole brand in one call:
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, in the device model summary shape.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 same apps that Compatible Apps shows.
device_models is paged. Every other field is the same on every page, so you can read them from the first page.
curl --compressed \
-H "Authorization: Bearer eco_sk_your_secret_key" \
"https://ecosystem.seam.co/v1/manufacturer_content/get"
curl --compressed -G \
"https://ecosystem.seam.co/v1/manufacturer_content/get" \
-d manufacturer_slug=schlage \
-d locale=fr \
-d limit=100
{
"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
}
Errors
Besides the errors every endpoint can return, this endpoint returns:| 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. |
Next Steps
- Filter device models by type, provider, or capability with List Device Model Summaries.
- Get your keys in Keys and Authentication.
Authorizations
secret_keyembed_keyembed_key_param
Optional on endpoints that serve published content. A secret key (eco_sk_…), sent as Authorization: Bearer eco_sk_… from your servers only. A manufacturer secret key implies its manufacturer and can include that manufacturer's device models hidden from third parties.
Query Parameters
Manufacturer slug. Optional with a manufacturer key, which implies its own; required otherwise.
Locale for resolved capability report text; unknown locales fall back to the default locale.
Optional device model data to add: commerce adds marketplace and shop listings, ASINs and GTINs.
Available options:
commerce Include models forbidden to third parties (is_forbidden_to_3dparty): all of them for Seam callers, its own for a manufacturer secret key, none otherwise. Defaults to false.
Maximum number of device models to return (1-500).
Required range:
1 <= x <= 500The pagination.next_page_cursor from the previous page.
Was this page helpful?