# AgentStall ZA – South African Government Tenders Search

> AgentStall ZA – South African Government Tenders Search is a paid API for AI agents from agentstall.nilesh-b54.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-02).

Search and filter live South African government tender listings by keyword, buyer, category, and closing date

## Facts

- Endpoint: GET https://agentstall.nilesh-b54.workers.dev/v1/tenders?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstall-za-south-african-government-tenders-search-e640c182
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K0afkVxnYuBw1oenUs5Zm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstall-za-south-african-government-tenders-search-e640c182
```

Example prompt: Find me open South African government tenders for security services from any municipality, limited to those closing within 30 days — show up to 20 results.

## When to prefer this

Use this endpoint when you need to search live South African government tender listings with filtering by keyword, buyer, category, or closing deadline. Prefer this over generic web search when you need structured, machine-readable tender data with reliable closing dates and buyer names, especially for automated bid monitoring or procurement pipeline workflows.

## Known failure modes

- 402 Payment Required with PAYMENT-REQUIRED header if the x402 USDC payment is missing or invalid
- Empty results array if no tenders match the given filters
- Invalid category value returns an error or empty results
- closing_within_days or limit out of allowed range may be rejected or clamped
- Keyword query with no matches returns totalMatches: 0

## How this service works

South African government tenders and RFQs: searches open tenders from national and provincial departments, municipalities and state-owned companies published on the National Treasury eTenders portal. Filter by keyword, closing date, category and buyer. Returns tender number, description, buyer, procurement method, opening and closing dates, and tender document links. Updated every 3 hours.

## Output

A JSON object containing an array of matching tender records (each with tender number, buyer name, description, and closing datetime in ISO 8601 UTC) and a totalMatches count indicating how many records matched the query in total.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Keywords, e.g. 'security services' or 'laptops -lease'"
      },
      "open": {
       "type": "string",
       "description": "Only tenders still open (default true)"
      },
      "buyer": {
       "type": "string",
       "description": "Part of the buyer's name, e.g. 'Municipality' or 'Transnet'"
      },
      "limit": {
       "type": "string",
       "description": "Maximum results, 1-50 (default 20)"
      },
      "category": {
       "type": "string",
       "description": "goods, services, works or consultingServices"
      },
      "closing_within_days": {
       "type": "string",
       "description": "Only tenders closing within N days (1-365)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "country": "ZA",
  "results": [
   {
    "link": "https://www.etenders.gov.za/",
    "buyer": "Matzikama Municipality",
    "opens": "2026-10-02T00:00:00+00:00",
    "closes": "2026-11-02T12:00:00+00:00",
    "method": "Request for Quotation",
    "category": "services",
    "documents": [
     {
      "url": "https://www.etenders.gov.za/home/Download?blobName=c86eb568-e00e-409c-a623-f910b696327f.pdf",
      "title": "T10-2026-2027 security.pdf",
      "format": "pdf"
     }
    ],
    "description": "Supply and installation of security cameras with monitors, alarms, beams and monitored security and response services for a 3-year period",
    "tenderNumber": "T10-2026-2027"
   }
  ],
  "totalMatches": 93,
  "indexedTenders": 5458
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstall-za-south-african-government-tenders-search-e640c182/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstall.nilesh-b54.workers.dev](https://www.zero.xyz/host/agentstall.nilesh-b54.workers.dev/llms.txt)