Wayfair

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.

Wayfair publishes 2 APIs on the APIs.io network: Authentication API and GraphQL API. Tagged areas include E-Commerce, Furniture, Home Goods, Retail, and Suppliers.

The Wayfair catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Wayfair’s developer surface includes authentication, developer portal, documentation, and 12 more developer resources.

🌐 Visit website 📡 Source on GitHub

53.9/100 developing ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

2 APIs 7 Features 4 Use Cases

E-CommerceFurnitureHome GoodsRetailSuppliersGraphQL

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 53.9/100 · developing

Contract Quality 20.5 / 25

Developer Ergonomics 5.7 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 4.8 / 13

Governance 8.3 / 12

Discoverability 6.9 / 10

Agent readiness — 44/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/wayfair: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 2

Individual APIs this provider publishes, each with its own machine-readable definition.

Wayfair Authentication API

Token-based authentication for API access.

Wayfair GraphQL API

GraphQL query and mutation operations for supplier management.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Wayfair Supplier API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

Wayfair GraphQL API

GraphQL-based API for Wayfair suppliers to manage orders, inventory, product catalogs, shipping notifications, and returns. Provides access to purchase orders, inventory updates...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Wayfair Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Wayfair Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Wayfair Finops

FINOPS

Features 7

Notable capabilities this provider offers.

GraphQL Supplier API

Unified GraphQL endpoint enabling suppliers to query and mutate data across orders, inventory, catalog, and shipping with precise data fetching.

Purchase Order Management

Suppliers retrieve, acknowledge, and manage purchase orders from Wayfair buyers through the GraphQL API.

Inventory Management

Real-time inventory updates and stock level management for the Wayfair marketplace catalog.

Product Catalog Management

Suppliers manage product listings, pricing, descriptions, and attributes through the Product Catalog Update API.

Advanced Shipment Notifications

Suppliers submit ASN (Advanced Shipment Notification) data to notify Wayfair of pending shipments, carrier details, and tracking numbers.

Sandbox Testing Environment

Full sandbox environment at sandbox.api.wayfair.com/v1/graphql for integration testing without affecting production orders.

OAuth2 Token Authentication

Client credentials flow authentication issuing temporary access tokens for secure API access.

Scroll for all 7

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Wayfair Context

5 classes · 15 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Wayfair API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Wayfair API Rules

35 rules · 14 errors 20 warnings 1 info

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

GraphQLError

3 properties

JSON SCHEMA

GraphQLRequest

3 properties

JSON SCHEMA

GraphQLResponse

2 properties

JSON SCHEMA

TokenRequest

2 properties

JSON SCHEMA

TokenResponse

3 properties

JSON SCHEMA

JSON Structure 5

JSON Structure definitions describing this provider's data shapes.

Wayfair Graph Ql Error Structure

3 properties

JSON STRUCTURE

Wayfair Graph Ql Request Structure

3 properties

JSON STRUCTURE

Wayfair Graph Ql Response Structure

2 properties

JSON STRUCTURE

Wayfair Token Request Structure

2 properties

JSON STRUCTURE

Wayfair Token Response Structure

3 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Wayfair Graph Ql Error Example

3 fields

EXAMPLE

Wayfair Graph Ql Request Example

3 fields

EXAMPLE

Wayfair Graph Ql Response Example

2 fields

EXAMPLE

Wayfair Token Request Example

2 fields

EXAMPLE

Wayfair Token Response Example

3 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Wayfair Authentication

http · 1 scheme

SECURITY

Wayfair Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Wayfair Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Wayfair Agentic Access

2 operations · 2 acting

AGENTIC

Use Cases 4

What developers build with this provider.

Order Fulfillment Automation

Suppliers automate purchase order retrieval, acknowledgment, and fulfillment workflows to reduce manual processing time.

Inventory Synchronization

Real-time synchronization of warehouse inventory levels with the Wayfair marketplace to prevent overselling.

Product Catalog Updates

Batch and real-time updates to product listings, pricing, and attributes in the Wayfair catalog.

Shipping Notification Automation

Automated submission of ASN data and tracking information when orders are shipped from supplier warehouses.

Integrations 3

Pre-built integrations with other platforms and tools.

Wayfair Sandbox

Full sandbox environment for integration testing before deploying to the production Wayfair platform.

Apollo GraphQL Federation

Wayfair's federated GraphQL architecture enables domain-oriented microservices composition behind a unified supplier API.

OAuth2 Authentication

Standard OAuth2 client credentials flow for secure supplier application authentication.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Developer Portal

Portal

Developer Portal (Introduction)

Portal

Documentation 2

Reference material describing how the API behaves

GraphQL Documentation

Documentation

Sandbox API Testing

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Wayfair Spectral Rules

SpectralRules

Wayfair Vocabulary

Vocabulary

Wayfair JSON-LD Context

JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

Wayfair GitHub Organization

GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

Company 3

The organization behind the API

LinkedIn

Wayfair Website

Website

About Wayfair

About

Source (apis.yml)

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
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/wayfair.png
tags:
- E-Commerce
- Furniture
- Home Goods
- Retail
- Suppliers
- GraphQL
created: '2025-03-01'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
- aid: wayfair:wayfair-authentication-api
  name: Wayfair Authentication API
  description: Token-based authentication for API access.
  humanURL: https://developer.wayfair.com/docs/
  baseURL: https://api.wayfair.com/v1/graphql
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/wayfair-authentication-api-openapi.yml
  - type: Documentation
    url: https://developer.wayfair.com/docs/
  - type: Documentation
    url: https://developer.wayfair.io/posts/graphQL
  - type: JSONSchema
    url: json-schema/wayfair-graph-ql-request-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-graph-ql-response-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-token-request-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-token-response-schema.json
  - type: JSONStructure
    url: json-structure/wayfair-graph-ql-request-structure.json
  - type: JSONStructure
    url: json-structure/wayfair-graph-ql-response-structure.json
  - type: Examples
    url: examples/wayfair-graph-ql-request-example.json
  - type: Examples
    url: examples/wayfair-token-request-example.json
  - type: GraphQL
    url: graphql/wayfair-graphql.md
- aid: wayfair:wayfair-graphql-api
  name: Wayfair GraphQL API
  description: GraphQL query and mutation operations for supplier management.
  humanURL: https://developer.wayfair.com/docs/
  baseURL: https://api.wayfair.com/v1/graphql
  tags:
  - GraphQL
  properties:
  - type: OpenAPI
    url: openapi/wayfair-graphql-api-openapi.yml
  - type: Documentation
    url: https://developer.wayfair.com/docs/
  - type: Documentation
    url: https://developer.wayfair.io/posts/graphQL
  - type: JSONSchema
    url: json-schema/wayfair-graph-ql-request-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-graph-ql-response-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-token-request-schema.json
  - type: JSONSchema
    url: json-schema/wayfair-token-response-schema.json
  - type: JSONStructure
    url: json-structure/wayfair-graph-ql-request-structure.json
  - type: JSONStructure
    url: json-structure/wayfair-graph-ql-response-structure.json
  - type: Examples
    url: examples/wayfair-graph-ql-request-example.json
  - type: Examples
    url: examples/wayfair-token-request-example.json
  - type: GraphQL
    url: graphql/wayfair-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/wayfair-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/wayfair-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/wayfair-domain-security.yml
- type: Authentication
  url: authentication/wayfair-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/wayfair
- 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: Vocabulary
  url: vocabulary/wayfair-vocabulary.yml
  title: Wayfair Vocabulary
- type: JSONLD
  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