> ## Documentation Index
> Fetch the complete documentation index at: https://www.seam.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Manufacturer

> Returns one published manufacturer by `slug` or `manufacturer_id`, with logos, default device images, providers and its device model count. `device_model_count` counts only the device models the caller can see: models hidden from third parties count only for their manufacturer's secret key.

To get a manufacturer together with its device models, providers, and compatible apps, use [Get Manufacturer Content](/docs/device-manufacturer-guidance/manufacturer-api/manufacturer-content).


## OpenAPI

````yaml device-manufacturer-guidance/manufacturer-api/openapi.json GET /manufacturers/get
openapi: 3.1.0
info:
  title: Seam Ecosystem API
  version: 1.0.0
  description: >-
    Read what Seam publishes about the devices it supports: manufacturers,
    device models with their images, variants and capabilities, the providers
    that integrate them, and the partner apps that support them through Seam.


    Every endpoint accepts `GET` with query parameters, or `POST` with the same
    parameters as a JSON body. Successful responses include `"ok": true`.
    Published content is public, so you can call most endpoints without a key.
    Send an embed key from a browser, or a secret key from your servers, to
    identify yourself.
servers:
  - url: https://ecosystem.seam.co/v1
security: []
externalDocs:
  description: Manufacturer API guide
  url: https://www.seam.co/docs/device-manufacturer-guidance/manufacturer-api
paths:
  /manufacturers/get:
    get:
      tags:
        - manufacturers
      summary: Get a manufacturer
      description: >-
        Returns one published manufacturer by `slug` or `manufacturer_id`, with
        logos, default device images, providers and its device model count.
        `device_model_count` counts only the device models the caller can see:
        models hidden from third parties count only for their manufacturer's
        secret key.
      parameters:
        - name: slug
          in: query
          required: false
          schema:
            description: Manufacturer slug; provide this or `manufacturer_id`.
            type: string
        - name: manufacturer_id
          in: query
          required: false
          schema:
            description: Manufacturer UUID; provide this or `slug`.
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  manufacturer:
                    type: object
                    properties:
                      manufacturer_id:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        description: Ecosystem UUID of the manufacturer.
                      slug:
                        type: string
                        description: Stable identifier, e.g. `schlage`.
                      display_name:
                        description: Display name.
                        type:
                          - string
                          - 'null'
                      website:
                        description: Website URL, when recorded.
                        type:
                          - string
                          - 'null'
                      headquarters:
                        description: Headquarters location, when recorded.
                        type:
                          - string
                          - 'null'
                      country_of_origin:
                        description: Country of origin, when recorded.
                        type:
                          - string
                          - 'null'
                      parent_org:
                        description: >-
                          Parent organization or brand the manufacturer is sold
                          under.
                        type:
                          - string
                          - 'null'
                      inc_date:
                        description: >-
                          Incorporation year as recorded in the source, not a
                          date.
                        type:
                          - string
                          - 'null'
                      customer_support_phone:
                        description: Customer support phone, when recorded.
                        type:
                          - string
                          - 'null'
                      customer_support_email:
                        description: Customer support email, when recorded.
                        type:
                          - string
                          - 'null'
                      customer_support_url:
                        description: Customer support URL, when recorded.
                        type:
                          - string
                          - 'null'
                      description_md:
                        description: Description in markdown, when recorded.
                        type:
                          - string
                          - 'null'
                      seam_api_guide:
                        description: Seam API guide reference, when recorded.
                        type:
                          - string
                          - 'null'
                      commerce_footprint:
                        anyOf:
                          - 8fec0a58-f176-4da5-8d72-419fa835fc01
                          - type: 'null'
                        description: >-
                          Commerce footprint verbatim from the source; null
                          where the source holds none.
                      last_commerce_search_at:
                        anyOf:
                          - type: string
                            format: date-time
                            pattern: >-
                              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                          - type: 'null'
                        description: >-
                          When commerce listings were last searched; null is a
                          recorded fact, not an omission.
                      logos:
                        type: array
                        items:
                          type: object
                          properties:
                            asset_id:
                              type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              description: Ecosystem UUID of the asset.
                            kind:
                              type: string
                              enum:
                                - square_logo
                                - square_logo_mono
                                - horizontal_logo
                                - horizontal_logo_mono
                                - default_device_image
                                - featured
                                - variant_image
                              description: >-
                                Asset role: a logo kind, a manufacturer default
                                device image, a model featured image, or a
                                variant image.
                            object_key:
                              type: string
                              description: Immutable object-storage key.
                            url:
                              type: string
                              description: Public URL of the original image.
                            mime:
                              description: Media type, when known.
                              type:
                                - string
                                - 'null'
                            width:
                              anyOf:
                                - type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                - type: 'null'
                              description: Width in pixels, when known.
                            height:
                              anyOf:
                                - type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                - type: 'null'
                              description: Height in pixels, when known.
                            bytes:
                              anyOf:
                                - type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                - type: 'null'
                              description: Size in bytes, when known.
                            sha256:
                              description: SHA-256 of the original bytes, when recorded.
                              type:
                                - string
                                - 'null'
                            sort_order:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Ordering within the owning version's assets.
                            formats:
                              type: object
                              propertyNames:
                                type: string
                                enum:
                                  - thumbnail
                                  - small
                                  - medium
                                  - large
                              additionalProperties:
                                type: object
                                properties:
                                  object_key:
                                    type: string
                                    description: >-
                                      Immutable object-storage key of this
                                      format.
                                  url:
                                    type: string
                                    description: Public URL of this format.
                                  mime:
                                    description: Media type, when known.
                                    type:
                                      - string
                                      - 'null'
                                  width:
                                    anyOf:
                                      - type: integer
                                        minimum: -9007199254740991
                                        maximum: 9007199254740991
                                      - type: 'null'
                                    description: Width in pixels, when known.
                                  height:
                                    anyOf:
                                      - type: integer
                                        minimum: -9007199254740991
                                        maximum: 9007199254740991
                                      - type: 'null'
                                    description: Height in pixels, when known.
                                  bytes:
                                    anyOf:
                                      - type: integer
                                        minimum: -9007199254740991
                                        maximum: 9007199254740991
                                      - type: 'null'
                                    description: Size in bytes, when known.
                                  sha256:
                                    description: >-
                                      SHA-256 of this format's bytes, when
                                      recorded.
                                    type:
                                      - string
                                      - 'null'
                                required:
                                  - object_key
                                  - url
                                  - mime
                                  - width
                                  - height
                                  - bytes
                                  - sha256
                                additionalProperties: false
                              description: >-
                                Derived image formats actually present in the
                                source; an empty object means the source held
                                none (e.g. SVG logos).
                            created_at:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                              description: Creation time (ISO 8601).
                            updated_at:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                              description: Last update time (ISO 8601).
                          required:
                            - asset_id
                            - kind
                            - object_key
                            - url
                            - mime
                            - width
                            - height
                            - bytes
                            - sha256
                            - sort_order
                            - formats
                            - created_at
                            - updated_at
                          additionalProperties: false
                        description: >-
                          Square and horizontal logos in color and monochrome
                          variants.
                      default_device_images:
                        type: array
                        items:
                          type: object
                          properties:
                            device_type:
                              type: object
                              properties:
                                device_type_id:
                                  type: string
                                  format: uuid
                                  pattern: >-
                                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                  description: Ecosystem UUID of the device type.
                                slug:
                                  type: string
                                  description: Stable identifier, e.g. `smartlock`.
                                display_name:
                                  type: string
                                  description: Display name.
                                is_accessory:
                                  type: boolean
                                  description: >-
                                    Accessory types (bridges, keypads) rather
                                    than primary devices.
                              required:
                                - device_type_id
                                - slug
                                - display_name
                                - is_accessory
                              additionalProperties: false
                              description: Device type this fallback image applies to.
                            asset:
                              type: object
                              properties:
                                asset_id:
                                  type: string
                                  format: uuid
                                  pattern: >-
                                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                                  description: Ecosystem UUID of the asset.
                                kind:
                                  type: string
                                  enum:
                                    - square_logo
                                    - square_logo_mono
                                    - horizontal_logo
                                    - horizontal_logo_mono
                                    - default_device_image
                                    - featured
                                    - variant_image
                                  description: >-
                                    Asset role: a logo kind, a manufacturer
                                    default device image, a model featured
                                    image, or a variant image.
                                object_key:
                                  type: string
                                  description: Immutable object-storage key.
                                url:
                                  type: string
                                  description: Public URL of the original image.
                                mime:
                                  description: Media type, when known.
                                  type:
                                    - string
                                    - 'null'
                                width:
                                  anyOf:
                                    - type: integer
                                      minimum: -9007199254740991
                                      maximum: 9007199254740991
                                    - type: 'null'
                                  description: Width in pixels, when known.
                                height:
                                  anyOf:
                                    - type: integer
                                      minimum: -9007199254740991
                                      maximum: 9007199254740991
                                    - type: 'null'
                                  description: Height in pixels, when known.
                                bytes:
                                  anyOf:
                                    - type: integer
                                      minimum: -9007199254740991
                                      maximum: 9007199254740991
                                    - type: 'null'
                                  description: Size in bytes, when known.
                                sha256:
                                  description: >-
                                    SHA-256 of the original bytes, when
                                    recorded.
                                  type:
                                    - string
                                    - 'null'
                                sort_order:
                                  type: integer
                                  minimum: -9007199254740991
                                  maximum: 9007199254740991
                                  description: Ordering within the owning version's assets.
                                formats:
                                  type: object
                                  propertyNames:
                                    type: string
                                    enum:
                                      - thumbnail
                                      - small
                                      - medium
                                      - large
                                  additionalProperties:
                                    type: object
                                    properties:
                                      object_key:
                                        type: string
                                        description: >-
                                          Immutable object-storage key of this
                                          format.
                                      url:
                                        type: string
                                        description: Public URL of this format.
                                      mime:
                                        description: Media type, when known.
                                        type:
                                          - string
                                          - 'null'
                                      width:
                                        anyOf:
                                          - type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                          - type: 'null'
                                        description: Width in pixels, when known.
                                      height:
                                        anyOf:
                                          - type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                          - type: 'null'
                                        description: Height in pixels, when known.
                                      bytes:
                                        anyOf:
                                          - type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                          - type: 'null'
                                        description: Size in bytes, when known.
                                      sha256:
                                        description: >-
                                          SHA-256 of this format's bytes, when
                                          recorded.
                                        type:
                                          - string
                                          - 'null'
                                    required:
                                      - object_key
                                      - url
                                      - mime
                                      - width
                                      - height
                                      - bytes
                                      - sha256
                                    additionalProperties: false
                                  description: >-
                                    Derived image formats actually present in
                                    the source; an empty object means the source
                                    held none (e.g. SVG logos).
                                created_at:
                                  type: string
                                  format: date-time
                                  pattern: >-
                                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  description: Creation time (ISO 8601).
                                updated_at:
                                  type: string
                                  format: date-time
                                  pattern: >-
                                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                                  description: Last update time (ISO 8601).
                              required:
                                - asset_id
                                - kind
                                - object_key
                                - url
                                - mime
                                - width
                                - height
                                - bytes
                                - sha256
                                - sort_order
                                - formats
                                - created_at
                                - updated_at
                              additionalProperties: false
                              description: Fallback image asset for that device type.
                          required:
                            - device_type
                            - asset
                          additionalProperties: false
                        description: Fallback device image per device type.
                      providers:
                        type: array
                        items:
                          type: object
                          properties:
                            provider_id:
                              type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              description: Ecosystem UUID of the provider.
                            slug:
                              type: string
                              description: Stable identifier, e.g. `salto-ks`.
                            display_name:
                              description: Display name.
                              type:
                                - string
                                - 'null'
                          required:
                            - provider_id
                            - slug
                            - display_name
                          additionalProperties: false
                        description: Providers this manufacturer's devices integrate with.
                      device_model_count:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        description: >-
                          Number of published device models for this
                          manufacturer that the caller may list. Models
                          forbidden to third parties count only for Seam
                          callers, and for a manufacturer secret key only its
                          own.
                      created_at:
                        type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        description: Creation time (ISO 8601).
                      updated_at:
                        type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        description: Last update time (ISO 8601).
                    required:
                      - manufacturer_id
                      - slug
                      - display_name
                      - website
                      - headquarters
                      - country_of_origin
                      - parent_org
                      - inc_date
                      - customer_support_phone
                      - customer_support_email
                      - customer_support_url
                      - description_md
                      - seam_api_guide
                      - commerce_footprint
                      - last_commerce_search_at
                      - logos
                      - default_device_images
                      - providers
                      - device_model_count
                      - created_at
                      - updated_at
                    additionalProperties: false
                    description: The published manufacturer.
                  ok:
                    type: boolean
                    const: true
                    description: Always `true` on success.
                required:
                  - manufacturer
                  - ok
                additionalProperties: false
                $defs:
                  __schema0:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                      - type: 'null'
                      - type: array
                        items:
                          $ref: >-
                            #/paths/~1manufacturers~1get/get/responses/200/content/application~1json/schema/$defs/__schema0
                      - type: object
                        propertyNames:
                          type: string
                        additionalProperties:
                          $ref: >-
                            #/paths/~1manufacturers~1get/get/responses/200/content/application~1json/schema/$defs/__schema0
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                    description: Always `false` on error.
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Machine-readable error type.
                      message:
                        type: string
                        description: Human-readable error message.
                      request_id:
                        type: string
                        description: Request ID to include when you contact Seam.
                      data:
                        description: >-
                          Details for some error types, such as validation
                          issues.
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                    required:
                      - type
                      - message
                      - request_id
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '401':
          description: The key is unknown, revoked or unsupported
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                    description: Always `false` on error.
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Machine-readable error type.
                      message:
                        type: string
                        description: Human-readable error message.
                      request_id:
                        type: string
                        description: Request ID to include when you contact Seam.
                      data:
                        description: >-
                          Details for some error types, such as validation
                          issues.
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                    required:
                      - type
                      - message
                      - request_id
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '403':
          description: >-
            The key does not allow this request, such as an origin that is not
            allowed
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                    description: Always `false` on error.
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Machine-readable error type.
                      message:
                        type: string
                        description: Human-readable error message.
                      request_id:
                        type: string
                        description: Request ID to include when you contact Seam.
                      data:
                        description: >-
                          Details for some error types, such as validation
                          issues.
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                    required:
                      - type
                      - message
                      - request_id
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  ok:
                    type: boolean
                    const: false
                    description: Always `false` on error.
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Machine-readable error type.
                      message:
                        type: string
                        description: Human-readable error message.
                      request_id:
                        type: string
                        description: Request ID to include when you contact Seam.
                      data:
                        description: >-
                          Details for some error types, such as validation
                          issues.
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                    required:
                      - type
                      - message
                      - request_id
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
      security:
        - {}
        - secret_key: []
        - embed_key: []
        - embed_key_param: []
components:
  securitySchemes:
    secret_key:
      type: http
      scheme: bearer
      bearerFormat: eco_sk_…
      description: >-
        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.
    embed_key:
      type: apiKey
      in: header
      name: X-Embed-Key
      description: >-
        An embed key (`eco_live_…`) for browser requests; the request's `Origin`
        must match one of the key's allowed origins. Optional on most endpoints,
        but `embed/resolve` always needs one, and so does `compatibility` from a
        browser on a site other than seam.co. A manufacturer embed key implies
        its manufacturer.
    embed_key_param:
      type: apiKey
      in: query
      name: embed_key
      description: >-
        An embed key sent as the `embed_key` query parameter instead of the
        `X-Embed-Key` header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.