Product Serials

Manage serial numbers for products that have serial tracking enabled.

Use cases: Use the Product Serials API to register serial numbers when receiving inventory and track them through sales.

GET/products/id/:id/serials

List all serial numbers for a product.

Path Parameters

Name	Type		Description
`id`	number	required	The product ID.

Request

curl -X GET "https://api.glance.co.il/products/id/:id/serials" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": [
    {
      "id": 1,
      "serialNumber": "SN-20240101-001",
      "productId": 1,
      "status": "available"
    },
    {
      "id": 2,
      "serialNumber": "SN-20240101-002",
      "productId": 1,
      "status": "sold"
    }
  ]
}

POST/products/id/:id/serials

Add serial numbers to a product.

Path Parameters

Name	Type		Description
`id`	number	required	The product ID.

Body Parameters

Name	Type		Description
`serialNumbers`	string[]	required	Array of serial number strings to add.

Request

curl -X POST "https://api.glance.co.il/products/id/:id/serials" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "serialNumbers": "example_serialNumbers"
}'

Response

{
  "data": [
    {
      "id": 3,
      "serialNumber": "SN-20240320-001",
      "productId": 1
    },
    {
      "id": 4,
      "serialNumber": "SN-20240320-002",
      "productId": 1
    }
  ]
}

PUT/products/serials/:id

Edit a serial number.

Path Parameters

Name	Type		Description
`id`	number	required	The serial record ID.

Body Parameters

Name	Type		Description
`serialNumber`	string	required	The new serial number value.

Request

curl -X PUT "https://api.glance.co.il/products/serials/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "serialNumber": "example_serialNumber"
}'

Response

{
  "data": {
    "id": 1,
    "serialNumber": "SN-UPDATED-001",
    "productId": 1
  }
}

DELETE/products/serials/:id

Delete a serial number.

Path Parameters

Name	Type		Description
`id`	number	required	The serial record ID.

Request

curl -X DELETE "https://api.glance.co.il/products/serials/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": {
    "success": true
  }
}