> ## 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.

# List Partners

> Lists published partners with their industries, solutions and logos. Filters combine with AND. Pages are ordered by slug.



## OpenAPI

````yaml device-manufacturer-guidance/manufacturer-api/openapi.json GET /partners/list
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:
  /partners/list:
    get:
      tags:
        - partners
      summary: List partners
      description: >-
        Lists published partners with their industries, solutions and logos.
        Filters combine with AND. Pages are ordered by slug.
      parameters:
        - name: slugs
          in: query
          required: false
          schema:
            description: Only partners with these slugs.
            type: array
            items:
              type: string
        - name: partner_ids
          in: query
          required: false
          schema:
            description: Only partners with these UUIDs.
            type: array
            items:
              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)$
        - name: is_live
          in: query
          required: false
          schema:
            description: Filter by whether the partner's Seam integration is live.
            anyOf:
              - type: boolean
              - type: string
                enum:
                  - 'true'
                  - 'false'
        - name: is_featured
          in: query
          required: false
          schema:
            description: Filter by whether Seam features the partner.
            anyOf:
              - type: boolean
              - type: string
                enum:
                  - 'true'
                  - 'false'
        - name: industry
          in: query
          required: false
          schema:
            description: Industry slug.
            type: string
        - name: solution
          in: query
          required: false
          schema:
            description: Solution slug.
            type: string
        - name: limit
          in: query
          required: false
          schema:
            default: 100
            description: Maximum number of partners to return (1-500).
            type: integer
            minimum: 1
            maximum: 500
        - name: page_cursor
          in: query
          required: false
          schema:
            description: The `next_page_cursor` from the previous page.
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  partners:
                    type: array
                    items:
                      type: object
                      properties:
                        partner_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 partner.
                        slug:
                          type: string
                          description: Stable identifier, e.g. `hospitable`.
                        display_name:
                          type: string
                          description: Display name.
                        website:
                          description: Website URL, when recorded.
                          type:
                            - string
                            - 'null'
                        description_md:
                          description: Markdown description written by Seam or the partner.
                          type:
                            - string
                            - 'null'
                        is_live:
                          type: boolean
                          description: >-
                            The partner's Seam integration is live for its
                            customers.
                        is_featured:
                          type: boolean
                          description: Featured by Seam in partner listings.
                        legacy_industry_featured:
                          type: boolean
                          description: >-
                            Legacy per-industry featured flag; use
                            `is_featured`.
                        industries:
                          type: array
                          items:
                            type: object
                            properties:
                              industry_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 industry.
                              slug:
                                type: string
                                description: Stable identifier, e.g. `short-term-rental`.
                              display_name:
                                type: string
                                description: Display name.
                              short_name:
                                description: Short display name, when set.
                                type:
                                  - string
                                  - 'null'
                            required:
                              - industry_id
                              - slug
                              - display_name
                              - short_name
                            additionalProperties: false
                          description: Industries the partner serves.
                        solutions:
                          type: array
                          items:
                            type: object
                            properties:
                              solution_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 solution.
                              slug:
                                type: string
                                description: >-
                                  Stable identifier, e.g.
                                  `property-management-system`.
                              display_name:
                                type: string
                                description: Display name.
                              short_name:
                                description: Short display name, when set.
                                type:
                                  - string
                                  - 'null'
                              type:
                                type: string
                                enum:
                                  - software
                                  - service
                                description: '`software` or `service`.'
                            required:
                              - solution_id
                              - slug
                              - display_name
                              - short_name
                              - type
                            additionalProperties: false
                          description: Kinds of software or service the partner offers.
                        assets:
                          type: array
                          items:
                            type: object
                            properties:
                              partner_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
                                  - product_image
                                description: Logo kind or `product_image`.
                              url:
                                type: string
                                format: uri
                                description: Public URL of the asset.
                              mime:
                                type: string
                                description: Media type.
                              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.
                              sort_order:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                                description: Display order within the partner.
                            required:
                              - partner_asset_id
                              - kind
                              - url
                              - mime
                              - width
                              - height
                              - sort_order
                            additionalProperties: false
                          description: Logos and product images in display order.
                        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:
                        - partner_id
                        - slug
                        - display_name
                        - website
                        - description_md
                        - is_live
                        - is_featured
                        - legacy_industry_featured
                        - industries
                        - solutions
                        - assets
                        - created_at
                        - updated_at
                      additionalProperties: false
                    description: Published partners.
                  pagination:
                    type: object
                    properties:
                      has_next_page:
                        type: boolean
                        description: Whether another page follows this one.
                      next_page_cursor:
                        description: Cursor for the next page; null on the last page.
                        type:
                          - string
                          - 'null'
                    required:
                      - has_next_page
                      - next_page_cursor
                    additionalProperties: false
                    description: Pagination for this page.
                  ok:
                    type: boolean
                    const: true
                    description: Always `true` on success.
                required:
                  - partners
                  - pagination
                  - ok
                additionalProperties: false
        '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
        '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: []

````

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