Price by Region

Retrieve regional commodity prices across Pakistan.

GET/3.0/commodities/region

Description

This endpoint provides detailed regional commodity pricing data across all major trade hubs and provinces in Pakistan. The data is sourced from provincial market committees and the Pakistan Bureau of Statistics (PBS), enabling analysis of localized price disparities and regional market variations.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "date": "2025-02-06",
      "commodity": "wheat",
      "region": "Punjab",
      "unit": "kg",
      "price": 2400,
      "national_avg": 2450,
      "difference_percent": -2.0
    },
    {
      "date": "2025-02-06",
      "commodity": "wheat",
      "region": "Sindh",
      "unit": "kg",
      "price": 2500,
      "national_avg": 2450,
      "difference_percent": 2.0
    }
  ]
}

Response Fields

Field	Type	Description
date	string	Date of the price data (YYYY-MM-DD)
commodity	string	Commodity name or code
region	string	Region or province name
unit	string	Unit of measurement (kg, liter, dozen, etc.)
price	number	Regional price (PKR per unit)
national_avg	number	National average price for comparison
difference_percent	number	Percentage difference from national average

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Latest Regional Commodity Prices

curl -X GET "https://csapis.com/3.0/commodities/region" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Regional Market Analysis: Compare prices across provinces and trade hubs
• Distribution Optimization: Optimize supply chain routing based on regional pricing
• Agricultural Trade: Identify arbitrage opportunities between regions
• Consumer Insights: Analyze regional purchasing power and price sensitivity
• Policy Planning: Design region-specific economic policies based on local pricing