# WooCommerce REST API

> WooCommerce REST API (v3) types for orders, order lines, refunds, products, variations, categories, reviews and customers.

- Page: https://library.schematica.io/model/a2600d809e0247aa869c00e61604831e
- Model type: Schema
- License: Apache 2.0
- Access type: Free
- Access method: API
- Model size: Small
- Formats: JSON Schema
- Domains: eCommerce / Retail
- Audiences: Developer
- Classifications: #vendor-api #api #ecommerce
- Open in CoreModels: https://go.coremodels.io/app/a2600d809e0247aa869c00e61604831e
- Listed in library: 2025-09-02
- Last updated: 2026-10-23

## Use cases

### Store Order Integration (eCommerce / Retail)

Developers create, view, update and delete Order records, with their OrderLineItem lines, to sync a store with fulfilment or ERP systems.

### Agent Grounding (eCommerce / Retail)

AI agents look up how an OrderRefund links to an Order before they write code or answer store questions.

### Product Catalog Sync (eCommerce / Retail)

Merchants and developers keep Product and ProductVariation records in step with a product information system.

### Customer Record Sync (eCommerce / Retail)

Developers create and update Customer records, with their Billing and Shipping details, to match a CRM or marketing system.

## Description

## Overview
The WooCommerce REST API lets clients create, read, update and delete store data with JSON requests. It is built on the WordPress REST API, and version 3 lives under /wp-json/wc/v3/. The types in this entry include Order, OrderLineItem, OrderRefund, Product, ProductVariation, ProductCategory, ProductReview and Customer. Order parts such as OrderTaxLine, OrderShippingLine and OrderCouponLine hold the tax, shipping and coupon lines of an Order. Report types such as ReportSalesSummary and ReportTopSellersItem hold sales report data. Developers can use this entry to check Order and Product shapes before they write store integrations.

## Top entities
Order, OrderLineItem, OrderRefund, OrderTaxLine, OrderShippingLine, OrderCouponLine, Product, ProductVariation, ProductCategory, ProductReview, ProductAttribute, Customer

## Mappings
- schema.org Order: conceptual. Order aligns in intent with schema.org Order, not field by field.

## For agents
Query the library's CoreModels project for Order and Product shapes before writing store integrations. Plugins can add fields, so check a live store's route schema too. Sample prompt: "Using the WooCommerce REST API schema in the Schematica Library, which fields of an Order hold the OrderLineItem lines and the Billing details?" Read via MCP: get_project_summary with graphProjectId a2600d809e0247aa869c00e61604831e.

## Provenance
Publisher: WooCommerce. License: Apache-2.0 (https://github.com/woocommerce/woocommerce-rest-api-docs/blob/trunk/LICENSE). Version: v3. Format: JSON Schema. Described by the Schema Librarian on 2026-10-23; auto-cataloged.

---

Source: https://library.schematica.io/model/a2600d809e0247aa869c00e61604831e