wc-rest-api-v4

Reference WooCommerce REST API v4 routes, authentication, and usage.

21|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wc-rest-api-v4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wc-rest-api-v4
Source: https://github.com/Lonsdale201/wp-agent-skills/tree/main/woocommerce/wc-rest-api-v4
Command: npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wc-rest-api-v4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides an up-to-date reference for using the WooCommerce REST API v4 (wc/v4), clarifying when to use v4 vs v3, and outlining route patterns, hook prefixes, authentication, and error handling to prevent common integration mistakes.

Core Features & Use Cases

  • Comprehensive route catalog overview for wc/v4, including resources like customers, orders, refunds, products, shipping zones, fulfillments, and per-group settings.
  • Guidance on choosing v4 over v3, understanding hook prefixes and response filters, and debugging WC REST API integrations.
  • Practical examples and patterns for PHP and JavaScript client calls, including authentication and standard REST conventions.

Quick Start

Identify a use case and start replacing wc/v3 calls with wc/v4 equivalents to leverage the newer route shapes and caching options.

Frequently Asked Questions about wc-rest-api-v4

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the difference between WooCommerce REST API v3 and v4?

You should migrate to WooCommerce REST API v4 to leverage newer route shapes and caching options. Use v4 for integrations requiring updated hook prefixes and response filters, while debugging v3 vs v4 differences to prevent common integration mistakes.

How do I authenticate WooCommerce REST API v4 requests from PHP or JavaScript?

Authenticate WooCommerce REST API v4 requests by applying standard REST conventions and WooCommerce authentication methods in your PHP or JavaScript client calls. The skill provides practical examples and patterns for securely integrating customers, orders, and products.

What hook prefixes and response filters are available for WooCommerce REST API v4?

WooCommerce REST API v4 utilizes specific hook prefixes and response filters tailored to the wc/v4 route catalog. Understanding these prefixes is critical for accurately extending endpoints for customers, orders, refunds, and shipping zones without breaking integrations.

Does WooCommerce REST API v4 support managing shipping zones and fulfillments?

Yes, WooCommerce REST API v4 supports managing shipping zones and fulfillments through its comprehensive route catalog. It also covers customers, orders, refunds, products, and per-group settings, allowing complete store management via standard REST conventions.

Why are my WooCommerce REST API v4 integration calls returning errors?

WooCommerce REST API v4 integration errors often stem from incorrect authentication, outdated v3 route patterns, or improper hook prefixes. Debugging these integrations requires checking route catalog details, standard REST conventions, and specific v4 error codes.