aid: wayfair name: Wayfair description: >- Wayfair Inc. is one of the world's largest online destinations for home goods and furniture, serving over 20 million customers and 10,000+ suppliers. Wayfair's Developer Portal provides GraphQL-based APIs enabling suppliers to manage purchase orders, inventory updates, product catalog management, advanced shipment notifications, and returns. The platform is built on federated GraphQL architecture using domain-oriented microservices, allowing suppliers to request only the data they need. type: Index url: https://raw.githubusercontent.com/api-evangelist/wayfair/refs/heads/main/apis.yml image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg tags: - E-Commerce - Furniture - Home Goods - Retail - Suppliers - GraphQL created: '2025-03-01' modified: '2026-05-03' specificationVersion: '0.19' apis: - aid: wayfair:wayfair-supplier-api name: Wayfair Supplier API description: >- GraphQL-based API for Wayfair suppliers to manage orders, inventory, product catalogs, shipping notifications, and returns. Provides access to purchase orders, inventory updates, catalog management, and advanced shipment notifications via a unified GraphQL endpoint at api.wayfair.com/v1/graphql. image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg humanURL: https://developer.wayfair.com/docs/ baseURL: https://api.wayfair.com/v1/graphql tags: - Catalog - E-Commerce - GraphQL - Inventory - Orders - Shipping - Suppliers properties: - type: Documentation url: https://developer.wayfair.com/docs/ - type: Documentation url: https://developer.wayfair.io/posts/graphQL title: GraphQL Documentation - type: OpenAPI url: openapi/wayfair-supplier-api.yml - type: JSONSchema url: json-schema/wayfair-graph-ql-request-schema.json title: GraphQL Request Schema - type: JSONSchema url: json-schema/wayfair-graph-ql-response-schema.json title: GraphQL Response Schema - type: JSONSchema url: json-schema/wayfair-token-request-schema.json title: Token Request Schema - type: JSONSchema url: json-schema/wayfair-token-response-schema.json title: Token Response Schema - type: JSONStructure url: json-structure/wayfair-graph-ql-request-structure.json title: GraphQL Request Structure - type: JSONStructure url: json-structure/wayfair-graph-ql-response-structure.json title: GraphQL Response Structure - type: Example url: examples/wayfair-graph-ql-request-example.json title: GraphQL Request Example - type: Example url: examples/wayfair-token-request-example.json title: Token Request Example common: - type: Portal url: https://developer.wayfair.com/docs/ title: Developer Portal - type: Portal url: https://developer.wayfair.io/posts/introduction title: Developer Portal (Introduction) - type: Documentation url: https://developer.wayfair.io/posts/graphQL title: GraphQL Documentation - type: Documentation url: https://developer.wayfair.io/posts/api-testing title: Sandbox API Testing - type: Website url: https://www.wayfair.com/ title: Wayfair Website - type: About url: https://www.aboutwayfair.com/ title: About Wayfair - type: GitHubOrganization url: https://github.com/wayfair title: Wayfair GitHub Organization - type: SpectralRules url: rules/wayfair-spectral-rules.yml title: Wayfair Spectral Rules - type: NaftikoCapability url: capabilities/supplier-operations.yaml title: Supplier Operations Capability - type: Vocabulary url: vocabulary/wayfair-vocabulary.yml title: Wayfair Vocabulary - type: JSON-LD url: json-ld/wayfair-context.jsonld title: Wayfair JSON-LD Context - type: Features data: - name: GraphQL Supplier API description: >- Unified GraphQL endpoint enabling suppliers to query and mutate data across orders, inventory, catalog, and shipping with precise data fetching. - name: Purchase Order Management description: >- Suppliers retrieve, acknowledge, and manage purchase orders from Wayfair buyers through the GraphQL API. - name: Inventory Management description: >- Real-time inventory updates and stock level management for the Wayfair marketplace catalog. - name: Product Catalog Management description: >- Suppliers manage product listings, pricing, descriptions, and attributes through the Product Catalog Update API. - name: Advanced Shipment Notifications description: >- Suppliers submit ASN (Advanced Shipment Notification) data to notify Wayfair of pending shipments, carrier details, and tracking numbers. - name: Sandbox Testing Environment description: >- Full sandbox environment at sandbox.api.wayfair.com/v1/graphql for integration testing without affecting production orders. - name: OAuth2 Token Authentication description: >- Client credentials flow authentication issuing temporary access tokens for secure API access. - type: UseCases data: - name: Order Fulfillment Automation description: >- Suppliers automate purchase order retrieval, acknowledgment, and fulfillment workflows to reduce manual processing time. - name: Inventory Synchronization description: >- Real-time synchronization of warehouse inventory levels with the Wayfair marketplace to prevent overselling. - name: Product Catalog Updates description: >- Batch and real-time updates to product listings, pricing, and attributes in the Wayfair catalog. - name: Shipping Notification Automation description: >- Automated submission of ASN data and tracking information when orders are shipped from supplier warehouses. - type: Integrations data: - name: Wayfair Sandbox description: >- Full sandbox environment for integration testing before deploying to the production Wayfair platform. - name: Apollo GraphQL Federation description: >- Wayfair's federated GraphQL architecture enables domain-oriented microservices composition behind a unified supplier API. - name: OAuth2 Authentication description: >- Standard OAuth2 client credentials flow for secure supplier application authentication. maintainers: - FN: Kin Lane email: kin@apievangelist.com