Stock

Real-time stock information (public)

Get all stock

get

Real-time stock for all products

Responses

200

Stock list

application/json

successbooleanOptionalExample: true

timestampstring · date-timeOptional

get/stock

GET /api/v2/stock HTTP/1.1
Host: bulkmail.shop
Accept: */*

200

Stock list

{
  "success": true,
  "data": [
    {
      "product_id": 1,
      "product_name": "text",
      "sku": "text",
      "stock_count": 1,
      "in_stock": true,
      "price": 1
    }
  ],
  "timestamp": "2026-01-01T00:00:00.000Z"
}

Get product stock

get

Path parameters

product_idintegerRequired

Responses

200

Product stock

application/json

successbooleanOptionalExample: true

404

Resource not found

application/json

get/stock/{product_id}

GET /api/v2/stock/{product_id} HTTP/1.1
Host: bulkmail.shop
Accept: */*

{
  "success": true,
  "data": {
    "product_id": 1,
    "product_name": "text",
    "sku": "text",
    "stock_count": 1,
    "in_stock": true,
    "price": 1
  }
}

Bulk check stock

get

Check stock for multiple products at once

Query parameters

idsstringRequired

Comma-separated product IDs (max 50)

Example: 1,2,3,4,5

Responses

200

Stock for requested products

application/json

successbooleanOptionalExample: true

get/stock/check

GET /api/v2/stock/check?ids=text HTTP/1.1
Host: bulkmail.shop
Accept: */*

200

Stock for requested products

{
  "success": true,
  "data": [
    {
      "product_id": 1,
      "stock_count": 1,
      "in_stock": true
    }
  ]
}

Stock by categories

get

Responses

200

Stock grouped by category

application/json

successbooleanOptionalExample: true

get/stock/categories

GET /api/v2/stock/categories HTTP/1.1
Host: bulkmail.shop
Accept: */*

200

Stock grouped by category

{
  "success": true,
  "data": [
    {
      "category": "text",
      "total_products": 1,
      "total_stock": 1
    }
  ]
}