Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Categories
  • Welcome 👋
  • Get Started
  • Create Your First App
  • Authorization
  • Webhooks
  • Conditional Webhooks
  • Security Considerations
  • Multi-Language Support
  • Responses
  • Pagination
  • Rate Limiting
  • Versioning
  • Change Log
  • Support
  • APIs
    • Orders
      • Create Order
      • List Orders
      • Order Details
      • Create Drafted Order
      • Update Order
      • Duplicate Order
      • Order Actions
    • Order Status
      • Update Order Status
      • Create Custom Order Status
      • List Order Statuses
      • Order Status Details
      • Update Custom Order Status
      • Update Bulk Orders Statuses
      • Sort Orders Statuses
    • Order Histories
      • List Order Histories
      • Create Order History
    • Order Tags
      • Create Order Tag
      • List Order Tags
      • Delete Order Tag
    • Order Invoice
      • Create Invoice
      • List Invoices
      • Invoice Details
      • Send Order Invoice
      • Create Order Invoice
    • Order Reservations
      • List Order Reservations
    • Order Items
      • List Order Items
      • Create Order Item
      • Update Order Item
      • Delete Order Item
    • Products
      • Create Product
      • List Products
      • Product Details
      • Update Product
      • Delete Product
      • Change Product Status
      • Product Details By SKU
      • Update Product By SKU
      • Delete Product By SKU
      • Update Product Price By SKU
      • Update Bulk Product Prices
      • Import Products
      • Bulk Product Actions
    • Product Options
      • Create Product Option
      • Product Option Details
      • Update Product Option
      • Delete Product Option
    • Product Quantity
      • List Product Quantities
      • Update Bulk Quantities
      • List Quantity Change Reasons
      • List Quantity Audit
      • Update Bulk Quantities by SKU
      • Update Quantity
      • Update Quantity By SKU
    • Product Variants
      • List Product Variants
      • Product Variant Details
      • Update Product Variant
      • Update Product Variant Quantity
    • Product Tags
      • Create Product Tag
      • List Product Tags
    • Product Images
      • Attach Image by SKU
      • Attach Video by SKU
      • Attach Youtube Video
      • Attach Image
      • Update Image
      • Delete Image
    • Product Option Values
      • Create Product Option Value
      • Product Option Value Details
      • Update Product Option Value
      • Delete Product Option Value
    • Abandoned Carts
      • List Abandoned Carts
      • Abandoned Cart Details
    • Customer Groups
      • Create Customer Group
      • List Customer Groups
      • Add Customers To Group Customer
      • Update Default Customer Group
      • Update Customer Group
      • Delete Customer Group
    • Customers
      • Create Customer
      • List Customers
      • Customer Details
      • Update Customer
      • Delete Customer
      • Ban Customer
      • Un-Ban customer
      • Import Customers
    • Digitals Product
      • Attach Digital Code
      • Attach Digital File
      • Delete Digital File
    • Categories
      • Create Category
        POST
      • List Categories
        GET
      • Category Details
        GET
      • Update Category
        PUT
      • Delete Category
        DELETE
      • Category Children
        GET
      • Categories Search
        GET
      • List Category Products
        GET
    • Exports
      • Export Orders
      • Exports Logs
      • List Export Templates
      • Create Export Template
      • Update Export Template
      • Delete Export Template
      • List Export Columns
      • Export Customers
      • Export Custom URLs
      • Export Products
    • Shipments
      • Create Shipment
      • List Shipments
      • Shipment Details
      • Shipment Tracking
      • Update Shipment Details
      • Cancel Shipment
      • Return Shipment
    • Shipping Companies
      • List Shipping Companies
      • Shipping Company Details
      • List Estimate Rates
      • Create Shipping Company
      • Update Shipping Company
      • Delete Shipping Company
      • Shipping Company Options
    • Shipping Zones
      • Create Shipping Zone
      • List Shipping Zones
      • Shipping Zone Details
      • Update Shipping Zone
      • Delete Shipping Zone
    • Shipping Rules
      • List Shipping Rules
      • Shipping Rule Details
      • Delete Shipping Rule
    • Countries
      • List Countries
      • Country Details
    • Product Option Templates
      • List Option Templates
      • Option Template Details
      • Delete Option Template
      • Update Option Template
      • Create Option Template
    • Taxes
      • Create Tax
      • List Taxes
      • Tax Details
      • Update Tax
      • Delete Tax
    • Coupons
      • Create Coupon
      • List Coupons
      • Coupon Details
      • Update Coupon
      • Delete Coupon
      • List Coupon Codes
    • Affiliates
      • List Affiliates
      • Affiliate Details
      • Create Affiliate
      • Update Affiliate
      • Delete Affiliate
    • Order Assignment
      • List Auto Assignment Rules
      • Order Assigned Employees Details
      • Update Auto Assignment Rule
      • Create Auto Assignment Rules
    • Special Offers
      • Create Special Offer
      • List Special Offers
      • Special Offer Details
      • Update Special Offer
      • Delete Special Offer
      • Change Special Offer Status
    • Transactions
      • List Transactions
      • Transaction Details
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank Details
    • Settlements
      • List Instant Settlements
      • Create Instant Settlement
      • Update Instant Settlement
      • Instant Settlement Details
    • Settings
      • Settings List
      • Update Setting Slug
      • Setting Details
    • Merchant
      • User Information Details
      • Store Information
    • Brands
      • Create Brand
      • List Brands
      • Brand Details
      • Update Brand
      • Delete Brand
    • Branches
      • Create Branch
      • List Branches
      • Branch Details
      • Update Branch
      • Delete Branch
    • Currencies
      • Activate Currencies
      • List Currencies
      • List Available Currencies
    • SEO
      • List SEO Settings
      • Update SEO Settings
    • Cities
      • List Cities
    • DNS Records
      • List DNS Records
      • Create DNS Record
      • Delete DNS Record
    • Languages
      • Add Language
      • List Languages
      • Update Language
    • Employees
      • List Employees
    • Advertisements
      • Create Advertisement
      • List Advertisements
      • Advertisement Details
      • Update Advertisement
      • Delete Advertisement
    • Webhooks
      • List Active Webhooks
      • List Events
      • Register Webhook
      • Deactivate Webhook
      • Update Webhook
    • Custom URLs
      • Import Custom URLs
    • Loyalty Points
      • Customer Loyalty Points
      • Update Customer Loyalty Points
    • Reviews
      • List Reviews
      • Review Details
      • Update Review
  • Webhooks - Store Events
    • Order
    • Product
    • Customer
    • Shippings
    • Shipments
    • Brand
    • Invoice
    • Category
    • Store
    • Special Offer
    • Cart
    • Miscellaneous
  1. Categories

List Categories

Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
GET
https://api.salla.dev/admin/v2
/categories
Categories
Last modified:2025-02-20 14:43:58
This endpoint allows you to list all categories related to your store directly from this endpoint. Also, it allows you to filter them using a keyword, the endpoint would return any category which name matches this keyword.
Scopes
categories.read- Categories Read Only

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Query Params
page
integer 
optional
The Pagination page number
keyword
string 
optional
A keyword to filter categories by a specific name.
status
string 
optional
The status of the category, whether or not it is active or hidden
with
array[string]
optional
Returns the response with translations or items (or both). Takes values with separated comma or array of either items, translations or both in this case:
with=items OR with=translations OR with[]=items&with[]=translations OR with=items,translations
Example:
translations

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.salla.dev/admin/v2/categories?page&keyword&status&with=translations'

Responses

🟢200Success
application/json
Body
status
number 
optional
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
success
boolean 
optional
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
data
array[object (Category) {14}] 
optional
id
number 
required
Category ID, is a unique identifier assigned to a specific product category, facilitating organized classification and efficient management of products within a similar group. List of categories can be found here.
name
string 
required
Category name is a descriptive label assigned to a product category, aiding in clear identification and organization of related products. 🌐 Support multi-language
image
string 
required
The category image
urls
object (Urls) 
required
To help companies and merchants, Salla provides a “urls” attribute that has been added to different modules to guide the merchants to have the full URL of this module from both scopes, the dashboard scope as a store admin, and as a customer.
parent_id
integer 
required
Category Parent ID refers to the unique identifier assigned to the parent category of a subcategory, establishing a hierarchical relationship between different levels of product classification.
sort_order
integer  | null 
required
The sequence or arrangement of categories when displayed to users.
status
enum<string> 
required
The category status indicates whether the category is currently visible and accessible to users active or intentionally concealed from view hidden. It essentially controls whether the category is publicly displayed or kept private within the system.
Allowed values:
activehidden
show_in
object 
required
has_hidden_products
boolean 
required
Whether or not the category has hidden products.
update_at
string 
required
The date where the category is updated in.
metadata
object 
required
sub_categories
array[string]
required
The subcategories list of the main category.
translations
object 
required
You will get this object in the response if you use with=translations query parameter.
Category translations are based on the store's enabled language locale. For instance, if the store supports both Arabic and English, the translations object will return two entries: ar for Arabic and en for English.
items
array[object (Category) {14}] 
required
You will get this array in the response if you use with=items query parameter.
pagination
object (Pagination) 
optional
For a better response behavior as well as maintain the best security level, All retrieving API endpoints use a mechanism to retrieve data in chunks called pagination. Pagination working by return only a specific number of records in each response, and through passing the page number you can navigate the different pages.
count
number 
required
Number of returned results.
total
number 
required
Number of all results.
perPage
number 
required
Number of results per page.
<= 65
currentPage
number 
required
Number of current page.
totalPages
number 
required
Number of total pages.
links
object 
required
Array of linkes to next and previous pages.
Examples
{
  "status": 200,
  "success": true,
  "data": [
    {
      "id": 1390018242,
      "name": "laptops",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/laptops/c1390018242",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 0,
      "status": "active",
      "show_in": {
        "app": true,
        "salla_points": true
      },
      "has_hidden_products": true,
      "update_at": "2024-10-24 13:24:48",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    },
    {
      "id": 115638743,
      "name": "welcome jojo",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/welcome-jojo/c115638743",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 0,
      "status": "active",
      "show_in": {
        "app": true,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-10-24 14:19:55",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    },
    {
      "id": 40297589,
      "name": "قطط",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/قطط/c40297589",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 1,
      "status": "active",
      "show_in": {
        "app": false,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-10-21 14:44:57",
      "metadata": {
        "title": "قطط",
        "description": "welcome",
        "url": "قطط"
      },
      "sub_categories": []
    },
    {
      "id": 774382199,
      "name": "طعام كلاب",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/كلاب/c774382199",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 2,
      "status": "hidden",
      "show_in": {
        "app": false,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-10-21 14:45:27",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    },
    {
      "id": 712043358,
      "name": "العناية",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/العناية/c712043358",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 3,
      "status": "active",
      "show_in": {
        "app": false,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-10-21 14:51:38",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    },
    {
      "id": 537348185,
      "name": "جميع الأقسام",
      "image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
      "urls": {
        "customer": "https://store.test/ar/jalal56s/جميع-الأقسام/c537348185",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 3,
      "status": "active",
      "show_in": {
        "app": true,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-09-06 13:01:49",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    },
    {
      "id": 355378101,
      "name": "فساتين",
      "image": null,
      "urls": {
        "customer": "https://store.test/ar/jalal56s/فساتين-سهرة/c355378101",
        "admin": "/categories"
      },
      "parent_id": 0,
      "sort_order": 4,
      "status": "active",
      "show_in": {
        "app": true,
        "salla_points": false
      },
      "has_hidden_products": false,
      "update_at": "2024-09-07 14:34:09",
      "metadata": {
        "title": "This product is amazing",
        "description": "This Product is one of the amazing things you can buy for yourself",
        "url": "https://salla.sa/dev-mvxlkrylzfanmuri/t-shirt/p1672908878"
      },
      "sub_categories": []
    }
  ],
  "pagination": {
    "count": 7,
    "total": 7,
    "perPage": 20,
    "currentPage": 1,
    "totalPages": 1,
    "links": []
  }
}
🟠401Unauthorized
Modified at 2025-02-20 14:43:58
Previous
Create Category
Next
Category Details