Get Listings

Endpoint

GET https://provider.nazel.sa/api/v1/listing

Authentication

{
  "Content-Type": "application/json",
  "Authorization": "Bearer <token>"
}

Query Parameters

Parameter	Type	Required	Description	Constraints
page	number	No	Page number	Minimum: 1, Default: 1
limit	number	No	Items per page	Maximum: 50, Default: 10

Example: ?page=2&limit=10

Response

{
    "content": [
        {
            "id": "jpPDyhMp0rjrAtyqCfI_CxBjqQv7H5K1Lm7_",
            "status": "active",
            "items": [
                {
                    "nameAr": "منتج تجريبي",
                    "nameEn": "testing product",
                    "price": 50,
                    "quantity": 1,
                    "category": "service"
                }
            ],
            "brand": {
                "nameAr": "منتج تجريبي",
                "nameEn": "testing product",
                "industry": "food"
            }
        }
    ],
    "recordCount": 6
}

Response Fields

Field	Type	Description
content	array	Array of listing objects
content[].id	string	Unique listing identifier
content[].status	string	Listing status
content[].items	array	Array of items in the listing
content[].items[].nameAr	string	Item name in Arabic
content[].items[].nameEn	string	Item name in English
content[].items[].price	number	Item price
content[].items[].quantity	number	Item quantity
content[].items[].category	string	Item category
content[].brand	object	Brand information
content[].brand.nameAr	string	Brand name in Arabic
content[].brand.nameEn	string	Brand name in English
content[].brand.industry	string	Brand industry
recordCount	number	Total number of records

Error Codes

• 400: Invalid query parameters
• 500: Internal server error