Products

Products in DealDome represent the winning items you're actively selling and tracking for profit & loss. Each product has a cost price that feeds into your financial calculations, so keeping this data accurate is key to reliable P&L reports. On this page, we'll walk through the endpoints for listing, creating, updating, and deleting products.

You need the products:read scope to list products and the products:write scope to create, update, or delete them.

The product model

The product model holds everything DealDome needs to track a winning product, including its cost price and current status.

Properties

Name
id
Type
integer
Description
Unique identifier for the product.
Name
name
Type
string
Description
The name of the product as it appears in your dashboard.
Name
cost_price
Type
number
Description
The cost price (COGS) per unit, used for profit calculations.
Name
status
Type
string
Description
Current status of the product — either active or archived.
Name
created_at
Type
timestamp
Description
Timestamp of when the product was created.
Name
updated_at
Type
timestamp
Description
Timestamp of when the product was last updated.

GET/products

List all products

This endpoint returns a list of all your products. You can filter by status to only see active or archived products.

Optional attributes

Name
status
Type
string
Description
Filter products by status — active or archived.
Name
limit
Type
integer
Description
Limit the number of products returned.
Name
offset
Type
integer
Description
Offset for pagination.

Request

GET

/products

curl -G https://api.dealdome.eu/products \
  -H "Authorization: Bearer {token}" \
  -d status=active \
  -d limit=10

Response

{
  "data": [
    {
      "id": 1,
      "name": "Posture Corrector Pro",
      "cost_price": 4.20,
      "status": "active",
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-03-01T14:22:00Z"
    },
    {
      "id": 2,
      "name": "LED Sunset Lamp",
      "cost_price": 6.50,
      "status": "active",
      "created_at": "2026-02-10T08:00:00Z",
      "updated_at": "2026-02-10T08:00:00Z"
    }
  ]
}

POST/products

Create a product

This endpoint lets you add a new winning product to your DealDome account. You'll need to provide the product name and cost price at a minimum.

Required attributes

Name
name
Type
string
Description
The name of the product.
Name
cost_price
Type
number
Description
The cost price per unit.

Optional attributes

Name
status
Type
string
Description
The initial status — defaults to active.

Request

POST

/products

curl https://api.dealdome.eu/products \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name": "Posture Corrector Pro", "cost_price": 4.20}'

Response

{
  "id": 1,
  "name": "Posture Corrector Pro",
  "cost_price": 4.20,
  "status": "active",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:30:00Z"
}

PUT/products/:id

Update a product

This endpoint lets you update an existing product. You can change the name, cost price, or status. Archiving a product removes it from active P&L calculations without deleting historical data.

Optional attributes

Name
name
Type
string
Description
The updated product name.
Name
cost_price
Type
number
Description
The updated cost price per unit.
Name
status
Type
string
Description
Set to archived to archive the product, or active to reactivate it.

Request

PUT

/products/1

curl -X PUT https://api.dealdome.eu/products/1 \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"cost_price": 3.80, "status": "archived"}'

Response

{
  "id": 1,
  "name": "Posture Corrector Pro",
  "cost_price": 3.80,
  "status": "archived",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-04-13T09:15:00Z"
}

DELETE/products/:id

Delete a product

This endpoint permanently deletes a product and all associated performance data. If you want to keep historical data, consider archiving the product instead by setting its status to archived.

Request

DELETE

/products/1

curl -X DELETE https://api.dealdome.eu/products/1 \
  -H "Authorization: Bearer {token}"