Categories

Categories

A category groups related parts in your inventory catalog. Categories are created and managed in the Desktop application; this API provides read access and the ability to discontinue them.

The Category Object

{
  "rec": 5,
  "name": "Fasteners",
  "description": "Bolts, nuts, screws, and related hardware",
  "active": true,
  "warehouse": 0,
  "nonStock": 0,
  "modified": "2023-07-14T09:30:00"
}

Note: The single-category response (GET /Category/{id}) includes additional fields (listTop, subCategory, useSerial, serialUnique, assignSerialNumber, created). The list responses (GET /Category, GET /Category/All) return the fields shown above.

List Active Categories

GET /Category

Returns active categories with standard pagination parameters.

{
  "value": [
    {
      "rec": 5,
      "name": "Fasteners",
      "description": "Bolts, nuts, screws, and related hardware",
      "active": true,
      "warehouse": 0,
      "nonStock": 0,
      "modified": "2023-07-14T09:30:00"
    },
    {
      "rec": 9,
      "name": "Electrical",
      "description": "Wiring, connectors, and components",
      "active": true,
      "warehouse": 0,
      "nonStock": 0,
      "modified": "2024-03-05T14:00:00"
    }
  ],
  "totalCount": 18,
  "page": 1,
  "pageSize": 25,
  "pageCount": 1,
  "hasMore": false
}

List All Categories

GET /Category/All

Includes discontinued categories. Uses the same response shape as the active list.

{
  "value": [
    {
      "rec": 3,
      "name": "Legacy Parts",
      "description": "Discontinued product line",
      "active": false,
      "warehouse": 0,
      "nonStock": 0,
      "modified": "2022-10-01T00:00:00"
    },
    {
      "rec": 5,
      "name": "Fasteners",
      "description": "Bolts, nuts, screws, and related hardware",
      "active": true,
      "warehouse": 0,
      "nonStock": 0,
      "modified": "2023-07-14T09:30:00"
    }
  ],
  "totalCount": 22,
  "page": 1,
  "pageSize": 25,
  "pageCount": 1,
  "hasMore": false
}

Get a Category

GET /Category/{id}

Returns 404 if the category does not exist.

GET /Category/5

{
  "rec": 5,
  "name": "Fasteners",
  "description": "Bolts, nuts, screws, and related hardware",
  "active": true,
  "warehouse": 0,
  "nonStock": 0,
  "modified": "2023-07-14T09:30:00"
}

Discontinue a Category

DELETE /Category/{id}

Marks the category as discontinued. Parts assigned to this category are not affected. Returns 200 with a confirmation message.

DELETE /Category/5

"Category Discontinued: 5"

Permissions