Costs Endpoints

Use these endpoints to manage Cost Tracker entries in MainWP Dashboard.

Use the MainWP Postman collection as the source of truth for request and response schemas.

Cost endpoints require the built-in Cost Tracker module to be enabled.

Route Matrix

Method	Path	Purpose	Key Params
GET	`/costs`	List costs	`page`, `per_page`, `search`, `include`, `exclude`, `status`, `category`, `type`
POST, PUT, PATCH	`/costs/add`	Create a cost	`name`, `price`, `payment_type`, `product_type`, `renewal_type`, one of `sites`/`groups`/`clients`
GET	`/costs/{id}`	Get one cost	`id`
POST, PUT, PATCH	`/costs/{id}/edit`	Edit a cost	Same fields as add
DELETE	`/costs/{id}/remove`	Remove a cost	`id`
GET	`/costs/{id}/sites`	List sites linked to a cost	`id`
GET	`/costs/{id}/clients`	List clients linked to a cost	`id`
POST	`/costs/batch`	Batch cost create/update/delete	`create[]`, `update[]`, `delete[]`

Key Request Fields

Common write fields (create/edit):

name, price, payment_type, license_type, product_type, product_slug
renewal_type, last_renewal, payment_method, cost_tracker_status
url, note, visual fields like product_color, icon_hidden
Relationship selectors: sites[], groups[], or clients[]

At least one target set (sites, groups, or clients) is required.

Representative Requests

Create a cost

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"Hosting Plan",
    "price":49.00,
    "payment_type":"subscription",
    "product_type":"hosting",
    "renewal_type":"monthly",
    "sites":[12]
  }' \
  "https://your-dashboard.com/wp-json/mainwp/v2/costs/add"

{
  "success": 1,
  "data": {
    "id": 22,
    "name": "Hosting Plan"
  }
}

Remove a cost

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://your-dashboard.com/wp-json/mainwp/v2/costs/22/remove"

{
  "success": 1,
  "message": "Cost deleted successfully."
}

Updates Endpoints Users Endpoints

⌘I

Getting Started

Understanding MainWP

Dashboard

Sites

Users

Updates

Plugins

Themes

Content Operations

Clients

API Reference

Troubleshooting

Customization

Advanced

Resources

Route Matrix

Key Request Fields

Representative Requests

Create a cost

Remove a cost

​Route Matrix

​Key Request Fields

​Representative Requests

​Create a cost

​Remove a cost

​Related Resources

Route Matrix

Key Request Fields

Representative Requests

Create a cost

Remove a cost

Related Resources