GET /api/family/category?limit=10&offset=0&status=1&keyword=&familyId=1&sortOrder=1&count=0 HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "status": 1,
  "message": "Request processed successfully",
  "data": [
    {
      "familyId": 1,
      "name": "Headphones",
      "attributeGroupList": []
    }
  ]
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Product families

List or retrieve Family Category

Get /api/family/category

Authentication: Vendor bearer token required for protected operations; verify exact permission decorator in controller.

Feature area: Product Families & Attributes

Implementation source: src/api/vendor/controllers/ProductController.ts

Request example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.

Response example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.

Example status: Illustrative. The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.

GET

api

family

Authorizations

Authorization

string

header

required

Paste the JWT access token returned by the corresponding login endpoint.

Query Parameters

limit

integer

Query parameter limit.

offset

integer

Query parameter offset.

status

integer

Query parameter status.

keyword

string

Query parameter keyword.

familyId

integer

Query parameter familyId.

sortOrder

integer

Query parameter sortOrder.

count

integer

Query parameter count.

Response

Successful response. Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema. Example is illustrative and does not guarantee a stable response contract.

status

integer

message

string

data

object[]

Show child attributes

Store API

Vendor API

List or retrieve Family Category

Authorizations

Query Parameters

Response