# Pakistan Government Tenders & Contract Awards (PPRA EPMS) (`dottti/pakistan-tender-radar`) Actor

Pakistan federal government tenders and awarded contracts from PPRA's e-Publish & Monitoring System as clean JSON: closing dates, bid security, sector, buyer office, winners, contract and tender values in PKR, bids received. Keyword, sector and date filters, plus a new-only mode for daily alerts.

- **URL**: https://apify.com/dottti/pakistan-tender-radar.md
- **Developed by:** [Dottti](https://apify.com/dottti) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 tender delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Pakistan Government Tenders & Contract Awards (PPRA EPMS)

Get Pakistan federal government tenders and awarded contracts from the [PPRA e-Publish & Monitoring System](https://epms.ppra.gov.pk) (EPMS) as clean JSON, CSV or Excel. EPMS is run by the Public Procurement Regulatory Authority. Federal ministries, divisions, armed forces units and state-owned companies publish their tenders and contract awards there.

- **Open tenders** with closing date and time, opening time, bid security, bid validity, sector, procurement category, method and the buying office.
- **Contract awards** with the winning company, its address, the contract value and the tender value in PKR, the number of bids received and the signing date.
- **Filters** for keywords, sector, category, tender type, local or international, organization, city, date and minimum contract value.
- **Alerts**: turn on `onlyNew` and schedule it. Each run returns only records you have not received yet.

### Who uses this

- **Suppliers and contractors in Pakistan** see new federal tenders in their sector every morning.
- **Foreign exporters and their local agents** find international tenders and the agencies that buy their products.
- **Sales and bid teams** track which companies win contracts, at what price, and against how many bidders.
- **Analysts, journalists and consultancies** study federal spending by agency, sector and value.

### What you get

One record per tender or award, newest first. These two records come from a real run on 21 October 2026.

A tender:

```json
{
  "recordType": "tender",
  "tenderNo": "TS0000016510E",
  "procurementMethod": "Procurement",
  "title": "Construction of Civil Works in Creeks AoR",
  "sector": "Civil Works",
  "referenceNo": "MFEC IT/47",
  "status": "Published",
  "advertisedDate": "2026-10-21",
  "closingAt": "2026-11-10T11:30:00+05:00",
  "organization": "Ministry of Defence",
  "office": "Pakistan Navy MFEC HQ 301 Creeks BDE",
  "city": "Sujawal",
  "tenderType": "Pre-qualification Notice (PQ)",
  "procurementCategory": "Works",
  "tenderNature": "Local",
  "url": "https://epms.ppra.gov.pk/public/tenders/tender-details/TS0000016510E",
  "currency": "PKR",
  "officeAddress": "HQ 301 Creeks BDE at Sujawal",
  "procurementProcedure": "Single Stage-One Envelope",
  "openingTime": "12:00 PM",
  "bidSecurityPkr": 0,
  "method": "Competitive Bidding",
  "workflowType": "Standard Evaluation Process",
  "corrigendumCount": 0
}
```

An award:

```json
{
  "recordType": "award",
  "contractNo": "PCN-9281787893",
  "referenceNo": "P65606",
  "organization": "Ministry of Interior and Narcotics Control",
  "title": "Office Stationery Items Tender for FY 2026-27",
  "winner": "M/s Firdous Enterprises",
  "winnerAddress": "Shop no 1 69 A Umar Park Ashiana Road BAnk Stop Ferozpor Road Lahore",
  "natureOfPurchase": "National",
  "tenderNo": "TS0000010071E",
  "office": "Sty Store",
  "city": "Lahore",
  "contractValuePkr": 11273326,
  "valueBand": "< Rs. 50 Million",
  "advertisedDate": "2026-10-14",
  "awardDocumentUrl": "https://epms.ppra.gov.pk/pdf?file=Y29udHJhY3RfZG9jdW1lbnRzL0ZpcmRvdXNfMDAwMS5wZGY=",
  "url": "https://epms.ppra.gov.pk/public/contracts/contract-details/PCN-9281787893",
  "currency": "PKR",
  "signedDate": "2026-10-14",
  "tenderValuePkr": 17600000,
  "bidsReceived": 5,
  "integrityPactSigned": false,
  "complaintReceived": false
}
```

#### Notes on the fields

- **Money** is in Pakistani rupees (PKR), as a plain number. `Rs. 11,273,326.00` becomes `11273326`.
- **Times** are Pakistan time, ISO 8601 with `+05:00`. Dates are `YYYY-MM-DD`.
- **Text stays as published.** Spelling and capital letters are kept as the agency typed them.
- **Detail fields** (office address, procedure, bid security, tender value, bids received) need `includeDetails`, which is on by default.
- **Contact data.** The named contact person, email and phone are left out unless you turn on `includeContactPerson`. Some of these are personal addresses.
- **Missing values** are `null`. The Actor never fills a gap with a guess.

### Input

| Field | What it does |
| --- | --- |
| `recordTypes` | `tenders`, `awards` or both. Default: tenders. |
| `keywords` | Words the portal searches in tender and contract text, for example `solar` or `vehicle`. |
| `matchMode` | `any` (default) or `all`. |
| `sectors` | PPRA sectors such as Info and Comm Tech, Health/Medicines, Civil Works or Vehicles. |
| `procurementCategories` | `goods`, `works`, `consultancy`, `nonConsultancy`. |
| `tenderTypes` | `tender`, `prequalification`, `rfp`, `eoi`. |
| `tenderNature` | `any`, `local` or `international`. |
| `organizationContains` | For example `WAPDA`, `NHA` or `Ministry of Health`. |
| `cityContains` | For example `Islamabad` or `Karachi`. |
| `publishedSince` | Skip records advertised before this date, `YYYY-MM-DD`. |
| `minContractValuePkr` | Keep awards worth at least this amount. |
| `includeDetails` | Opens each record for the detail fields. On by default. |
| `onlyNew` | Skip records delivered in earlier runs. Use with a schedule. |
| `stateKey` | A separate memory per alert when you run several. |
| `maxItems` | Hard cap on delivered tenders, and separately on delivered awards. Default 100. |

#### Example: IT tenders, international only

```json
{
  "recordTypes": ["tenders"],
  "sectors": ["14"],
  "tenderNature": "international",
  "maxItems": 200
}
```

#### Example: awards of 50 million rupees or more

```json
{
  "recordTypes": ["awards"],
  "minContractValuePkr": 50000000,
  "maxItems": 500
}
```

### Daily alert

1. Set your filters and turn on `onlyNew`. Give the alert a name in `stateKey`, for example `solar-tenders`.
2. Click **Save as a new task**.
3. In the task, open **Schedules** and add a daily schedule, for example 07:00 Pakistan time.
4. Add an integration (email, Slack, webhook, Google Sheets) to the task if you want the new rows sent to you.

Each run then returns only the tenders and awards published since the last run. The first run returns everything that matches, up to `maxItems`.

### Pricing

- **Tender delivered:** $0.005 per tender that passes your filters and is stored in your dataset ($5 per 1,000).
- **Award delivered:** $0.012 per contract award with its winner and value stored in your dataset ($12 per 1,000).

Filtering is free. You pay only for records delivered. `maxItems` caps the cost of any run.

### Limits

- EPMS covers federal procurement under PPRA rules. Provincial portals (Punjab, Sindh, Khyber Pakhtunkhwa, Balochistan) are separate and are not included.
- On 21 October 2026 the portal listed 2,188 active tenders and 880 contract awards. 87 of the active tenders were advertised on 20 and 21 October.
- The tender list holds active tenders only. Closed tenders and the tender history are not read.
- Each list page holds 50 rows. The Actor counts the rows it reads against the total the portal reports and stops when they match, when a page is empty, or at `maxPages` (default 60, enough for every active tender).
- The portal searches one keyword at a time. With several keywords and `any`, the Actor runs one search per keyword and removes duplicates. With `all`, the portal searches the first keyword and the Actor checks the others on the list fields.
- The tender list is roughly newest first. With `onlyNew`, the Actor stops after two list pages in a row with nothing new.
- Tender documents are not offered for download on the public pages. Award letters are linked as PDFs in `awardDocumentUrl` and are not downloaded.
- The Actor waits at least 1 second between requests and retries with backoff on HTTP 429, 5xx and network errors. If the portal blocks a cloud IP, it switches to a proxy by itself.
- Data comes from the public pages of epms.ppra.gov.pk. No login is used.

### Related Actors

- [China Government Tenders & Awards (CCGP)](https://apify.com/dottti/china-tender-radar)
- [Etimad Tender Radar, Saudi Government Tenders](https://apify.com/dottti/etimad-tender-radar)

### Development

```bash
npm install
npm test        # parser tests on saved live pages
apify run       # local run, reads storage/key_value_stores/default/INPUT.json
```

# Actor input Schema

## `recordTypes` (type: `array`):

Tenders are open notices you can still bid on. Awards are signed contracts with the winning company and the contract value.

## `keywords` (type: `array`):

Words searched by the portal in tender and contract text, for example computer, solar or vehicle. Leave empty for everything.

## `matchMode` (type: `string`):

any: at least one keyword. all: every keyword.

## `sectors` (type: `array`):

Keep tenders in these PPRA sectors.

## `procurementCategories` (type: `array`):

Goods, works, consultancy or non-consultancy services.

## `tenderTypes` (type: `array`):

Tender notice, prequalification, request for proposal or expression of interest.

## `tenderNature` (type: `string`):

Keep only local or only international tenders.

## `organizationContains` (type: `string`):

Keep records whose organization or office name contains this text, for example WAPDA, NHA or Ministry of Health.

## `cityContains` (type: `string`):

Keep records whose city contains this text, for example Islamabad or Karachi.

## `publishedSince` (type: `string`):

Date in YYYY-MM-DD format. Older records are skipped.

## `minContractValuePkr` (type: `integer`):

Keep awards whose contract value is at least this many Pakistani rupees.

## `includeCancelled` (type: `boolean`):

The active list also shows tenders marked Cancelled. They are skipped unless you turn this on.

## `includeDetails` (type: `boolean`):

Tenders: description, office address, procedure, method, bid security, bid validity, opening time, corrigendum count. Awards: tender value, bids received, signing date, integrity pact and complaint flags. Adds one request per record.

## `includeContactPerson` (type: `boolean`):

Named contact person, email and phone from the detail page. Some are personal addresses: only turn it on if you have a lawful reason to process them.

## `onlyNew` (type: `boolean`):

Remember delivered IDs and skip them next time. Use it with a daily schedule for alerts.

## `stateKey` (type: `string`):

Separate memory for each alert when you run several schedules with onlyNew.

## `maxItems` (type: `integer`):

Hard cap on delivered tenders and, separately, on delivered awards, newest first. You pay per record delivered, so this is also your cost cap.

## `maxPages` (type: `integer`):

Each list page holds 50 rows. About 2,200 active tenders fit in 45 pages.

## `requestDelayMs` (type: `integer`):

Pause before each request. Never lower than 1000 ms.

## `maxRetries` (type: `integer`):

Retries with backoff when the portal fails or asks to slow down.

## `proxyConfiguration` (type: `object`):

Normally not needed. After two connection errors in a row, or a 403 block, the Actor switches to this proxy, or to Apify datacenter and then residential proxy when empty.

## Actor input object example

```json
{
  "recordTypes": [
    "tenders",
    "awards"
  ],
  "matchMode": "any",
  "tenderNature": "any",
  "includeCancelled": false,
  "includeDetails": true,
  "includeContactPerson": false,
  "onlyNew": false,
  "stateKey": "default",
  "maxItems": 10,
  "maxPages": 60,
  "requestDelayMs": 1000,
  "maxRetries": 4
}
```

# Actor output Schema

## `records` (type: `string`):

Tenders with closing date, sector and buyer office; awards with winner and contract value in PKR.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "recordTypes": [
        "tenders",
        "awards"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("dottti/pakistan-tender-radar").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "recordTypes": [
        "tenders",
        "awards",
    ],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("dottti/pakistan-tender-radar").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "recordTypes": [
    "tenders",
    "awards"
  ],
  "maxItems": 10
}' |
apify call dottti/pakistan-tender-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dottti/pakistan-tender-radar"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/SJymOIQjBD2OsCtWd/builds/PjmXv0ZnQ8jtjrHXf/openapi.json