REST API Controllers Reference

WP Sell Services includes 20 dedicated REST API controllers. All endpoints use the base URL /wp-json/wpss/v1/. For authentication, pagination, and error handling, see REST API Overview.

1. Services (/services)

Manage service listings, packages, and metadata.

GET /services – List services
GET /services/{id} – Get service details
POST /services – Create service (vendor only)
PUT /services/{id} – Update service (owner/admin)
DELETE /services/{id} – Delete service (owner/admin)

2. Orders (/orders)

Handle order lifecycle, status changes, and order management.

GET /orders – List orders (filtered by user role)
GET /orders/{id} – Get order details
POST /orders/{id}/accept – Accept order (vendor)
POST /orders/{id}/start – Start work (vendor)
POST /orders/{id}/complete – Complete order (buyer)
POST /orders/{id}/cancel – Cancel order

3. Reviews (/reviews)

GET /reviews – List reviews
GET /reviews/{id} – Get review details
POST /reviews – Submit review (buyer, within review window)
PUT /reviews/{id} – Update review (owner)
DELETE /reviews/{id} – Delete review (owner/admin)

4. Vendors (/vendors)

GET /vendors – List vendors
GET /vendors/{id} – Get vendor profile
PUT /vendors/{id} – Update profile (own profile)
GET /vendors/{id}/services – Get vendor’s services
GET /vendors/{id}/stats – Get vendor statistics

5. Conversations (/conversations)

GET /conversations/{order_id} – Get messages for order
POST /conversations/{order_id}/message – Send message
PUT /conversations/{message_id}/read – Mark message as read

6. Disputes (/disputes)

GET /disputes – List disputes
GET /disputes/{id} – Get dispute details
POST /disputes – Open dispute
POST /disputes/{id}/message – Add evidence
POST /disputes/{id}/resolve – Resolve dispute (admin)

7. Buyer Requests (/buyer-requests)

GET /buyer-requests – List requests
GET /buyer-requests/{id} – Get request details
POST /buyer-requests – Post request (buyer)
PUT /buyer-requests/{id} – Update request
DELETE /buyer-requests/{id} – Delete request

8. Proposals (/proposals)

GET /proposals – List proposals (filtered by user)
GET /proposals/{id} – Get proposal details
POST /proposals – Submit proposal (vendor)
PUT /proposals/{id} – Update proposal
POST /proposals/{id}/accept – Accept proposal (buyer)
DELETE /proposals/{id} – Withdraw proposal (vendor)

9. Notifications (/notifications)

GET /notifications – List notifications
GET /notifications/unread – Get unread count
PUT /notifications/{id}/read – Mark as read
POST /notifications/read-all – Mark all as read
DELETE /notifications/{id} – Delete notification

10. Portfolio (/portfolio)

GET /portfolio – List portfolio items
GET /portfolio/{id} – Get portfolio item
POST /portfolio – Add portfolio item (vendor)
PUT /portfolio/{id} – Update portfolio item
DELETE /portfolio/{id} – Delete portfolio item

11. Earnings (/earnings)

GET /earnings – Get earnings summary (vendor)
GET /earnings/history – Earnings history
GET /earnings/withdrawals – Withdrawal history
POST /earnings/withdraw – Request withdrawal

12. Extension Requests (/extension-requests)

GET /extension-requests – List extension requests
POST /extension-requests – Request extension (vendor)
POST /extension-requests/{id}/approve – Approve (buyer)
POST /extension-requests/{id}/reject – Reject (buyer)

13. Milestones (/milestones) [PRO]

GET /milestones/{order_id} – Get order milestones
POST /milestones – Create milestone
POST /milestones/{id}/submit – Submit milestone (vendor)
POST /milestones/{id}/approve – Approve milestone (buyer)
POST /milestones/{id}/reject – Reject milestone (buyer)

14. Tipping (/tips)

POST /tips – Send tip to vendor
GET /tips/sent – Tips sent (buyer)
GET /tips/received – Tips received (vendor)

15. Seller Levels (/seller-levels)

GET /seller-levels – List level definitions
GET /seller-levels/{id} – Get level details
GET /seller-levels/progress – Get vendor progress (own profile)

16. Moderation (/moderation)

GET /moderation/services – Services pending approval
POST /moderation/services/{id}/approve – Approve service
POST /moderation/services/{id}/reject – Reject service
GET /moderation/reviews – Reviews pending moderation
POST /moderation/reviews/{id}/approve – Approve review

17. Favorites (/favorites)

GET /favorites – List favorites (buyer)
POST /favorites – Add to favorites
DELETE /favorites/{service_id} – Remove from favorites

18. Media (/media)

POST /media/upload – Upload file
GET /media/{id} – Get file info
DELETE /media/{id} – Delete file

19. Cart (/cart)

GET /cart – Get cart contents
POST /cart/add – Add service to cart
PUT /cart/update – Update cart item
DELETE /cart/remove – Remove from cart
POST /cart/clear – Clear cart

20. Auth (/auth) [PRO]

POST /auth/login – Login user
POST /auth/register – Register new user
POST /auth/logout – Logout
GET /auth/validate – Validate token
POST /auth/refresh – Refresh token