{
  "info": {
    "name": "Public procurement statistics (SBX-IHALE)",
    "description": "Public procurement statistics from EKAP records: competition, direct procurement, local-supplier share, concentration, province and sector volumes, and the top-10 authorities and contractors.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{SBX_API_KEY}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.servicebox.io",
      "type": "string"
    },
    {
      "key": "SBX_API_KEY",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "List authority types",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/authority-types",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "authority-types"
          ],
          "query": [],
          "variable": []
        },
        "description": "The kinds of buying authority (ministries, municipalities, universities, state-owned enterprises…). Free.\n\nCredits: 0"
      }
    },
    {
      "name": "Competition",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/competition-indices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "competition-indices"
          ],
          "query": [
            {
              "key": "dimension",
              "value": "overall",
              "description": "What to break down by. Default: `overall` (the whole country).",
              "disabled": true
            },
            {
              "key": "subject",
              "value": "string",
              "description": "One subject of the dimension: a province's plate code or name (34, İstanbul), a sector id or name, an authority-type id, or a procedure id. Default: every subject.",
              "disabled": true
            },
            {
              "key": "period",
              "value": "string",
              "description": "A year (2019–) or `all` (every year pooled). Default: every year and `all`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Tender competition per year: the number of tenders, the share won with a single bid (overall and for single-lot tenders), average lots and the average discount against the estimated cost — for the whole country or per province, sector, tender procedure or authority type. Robust for 2019–2024; the source's 2025–2026 result details are partial.\n\nCredits: 1"
      }
    },
    {
      "name": "Market concentration",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/concentration-indices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "concentration-indices"
          ],
          "query": [
            {
              "key": "dimension",
              "value": "overall",
              "description": "What to break down by. Default: `overall` (the whole country).",
              "disabled": true
            },
            {
              "key": "subject",
              "value": "string",
              "description": "One subject of the dimension: a province's plate code or name (34, İstanbul), a sector id or name, an authority-type id, or a procedure id. Default: every subject.",
              "disabled": true
            },
            {
              "key": "period",
              "value": "string",
              "description": "A year (2019–) or `all` (every year pooled). Default: every year and `all`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "How concentrated contract winners are, per year: contract and firm counts, the largest 1, 4 and 10 contractors' share of value and the Herfindahl–Hirschman index — for the whole country or per province or sector.\n\nCredits: 1"
      }
    },
    {
      "name": "Source datasets and release",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/datasets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "datasets"
          ],
          "query": [],
          "variable": []
        },
        "description": "The weekly release served, when it was loaded, and each source dataset with its row count and the citation its publisher asks for. Free.\n\nCredits: 0"
      }
    },
    {
      "name": "Direct procurement",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/direct-procurement-indices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "direct-procurement-indices"
          ],
          "query": [
            {
              "key": "dimension",
              "value": "overall",
              "description": "What to break down by. Default: `overall` (the whole country).",
              "disabled": true
            },
            {
              "key": "subject",
              "value": "string",
              "description": "One subject of the dimension: a province's plate code or name (34, İstanbul), a sector id or name, an authority-type id, or a procedure id. Default: every subject.",
              "disabled": true
            },
            {
              "key": "period",
              "value": "string",
              "description": "A year (2019–) or `all` (every year pooled). Default: every year and `all`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Direct procurement (doğrudan temin) per year: purchase count and the amount distribution (median, mean, total, 95th and 99th percentile, largest and its share), nominal TRY — for the whole country or per province, sector or authority type. 2025 is the reference year; earlier years are incomplete in the source.\n\nCredits: 1"
      }
    },
    {
      "name": "Local suppliers",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/localization-indices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "localization-indices"
          ],
          "query": [
            {
              "key": "dimension",
              "value": "overall",
              "description": "What to break down by. Default: `overall` (the whole country).",
              "disabled": true
            },
            {
              "key": "subject",
              "value": "string",
              "description": "One subject of the dimension: a province's plate code or name (34, İstanbul), a sector id or name, an authority-type id, or a procedure id. Default: every subject.",
              "disabled": true
            },
            {
              "key": "period",
              "value": "string",
              "description": "A year (2019–) or `all` (every year pooled). Default: every year and `all`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "The share of contracts, by count and by value, won by suppliers from the buying authority's own province, per year — for the whole country or per province or sector.\n\nCredits: 1"
      }
    },
    {
      "name": "Volume by province and sector",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/province-sectors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "province-sectors"
          ],
          "query": [
            {
              "key": "province",
              "value": "string",
              "description": "A province's plate code or name.",
              "disabled": true
            },
            {
              "key": "sector",
              "value": "string",
              "description": "A sector id from /public-procurement/sectors, or its Turkish or English name.",
              "disabled": true
            },
            {
              "key": "sort",
              "value": "amount",
              "description": "`amount` (default) or `tenders`, both descending.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Tender volume (count and value, nominal TRY) for each province and sector, with the value won by suppliers from the same province and from elsewhere. Largest first.\n\nCredits: 1"
      }
    },
    {
      "name": "List sectors",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/sectors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "sectors"
          ],
          "query": [],
          "variable": []
        },
        "description": "The 43 sectors tenders are classified into, with ids and English names. Free.\n\nCredits: 0"
      }
    },
    {
      "name": "Supply flows between provinces",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/supply-flows",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "supply-flows"
          ],
          "query": [
            {
              "key": "buyerProvince",
              "value": "string",
              "description": "The buying authorities' province: plate code or name.",
              "disabled": true
            },
            {
              "key": "supplierProvince",
              "value": "string",
              "description": "The suppliers' province: plate code or name.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "Contracts (count and value, nominal TRY) from authorities in one province to suppliers based in another or the same province. Largest first.\n\nCredits: 1"
      }
    },
    {
      "name": "Top-10 buying authorities",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/top-authorities",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "top-authorities"
          ],
          "query": [
            {
              "key": "province",
              "value": "string",
              "description": "A province's plate code or name. Give this or `sector`.",
              "disabled": true
            },
            {
              "key": "sector",
              "value": "string",
              "description": "A sector id or name. Give this or `province`.",
              "disabled": true
            },
            {
              "key": "method",
              "value": "tender",
              "description": "`tender` (default) or, for a province, `direct` (direct procurement).",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "The ten public authorities that awarded the most in one province (tenders or direct procurement) or one sector (tenders), by value.\n\nCredits: 1"
      }
    },
    {
      "name": "Top-10 contractors",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/v1/public-procurement/top-contractors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "v1",
            "public-procurement",
            "top-contractors"
          ],
          "query": [
            {
              "key": "province",
              "value": "string",
              "description": "A province's plate code or name. Give this or `sector`.",
              "disabled": true
            },
            {
              "key": "sector",
              "value": "string",
              "description": "A sector id or name. Give this or `province`.",
              "disabled": true
            },
            {
              "key": "method",
              "value": "tender",
              "description": "`tender` (default); for a province also `direct` or `headquartered`.",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "50",
              "description": "Items per page, 1–200.",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "string",
              "description": "The `next_cursor` of the previous page, with the same filters.",
              "disabled": true
            }
          ],
          "variable": []
        },
        "description": "The ten contractors that won the most in one province or sector (tenders), in one province by direct procurement (`direct`), or the ten firms based in a province with the most public-contract revenue anywhere (`headquartered`). Legal names as recorded in EKAP; no tax numbers.\n\nCredits: 1"
      }
    }
  ]
}