Categories

📂 Organize products into categories.

List All Categories

get

List all product categories.

Authorizations

ApiKeyAuth & StoreHashAuth

x-api-keystringRequired

Your PapelShip API Key

x-store-hashstringRequired

Your Store Hash ID

Responses

200

Successful response

application/json

get

/categories

HTTPcURLJavaScriptPython

GET /api_user/api/v1/categories HTTP/1.1
Host: papelship.com
x-api-key: YOUR_API_KEY
x-store-hash: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "success": true,
  "categories": [
    {
      "id": 5,
      "name": "Software",
      "slug": "software",
      "icon": "fa-solid fa-code",
      "active": 1,
      "parent_id": 1,
      "position": 0,
      "created_at": "2026-01-27T17:55:10.412Z"
    }
  ]
}

Create New Category

post

Create a new product category.

Authorizations

ApiKeyAuth & StoreHashAuth

x-api-keystringRequired

Your PapelShip API Key

x-store-hashstringRequired

Your Store Hash ID

Body

application/json

namestringRequired

slugstringRequired

Responses

200

Category created

application/json

post

/categories

HTTPcURLJavaScriptPython

POST /api_user/api/v1/categories HTTP/1.1
Host: papelship.com
x-api-key: YOUR_API_KEY
x-store-hash: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "name": "text",
  "slug": "text"
}

200

Category created

{
  "success": true,
  "category": {
    "id": 5,
    "name": "Software",
    "slug": "software",
    "icon": "fa-solid fa-code",
    "active": 1,
    "parent_id": 1,
    "position": 0,
    "created_at": "2026-01-27T17:55:10.412Z"
  }
}