🤖 Tender84 API for AI Agents

Connect ChatGPT, Claude, Gemini, and custom applications to 60,000+ live government tenders across India. Search, filter, and request bid documents programmatically.

OpenAPI 3.1 spec · MCP Server · GPT Actions · Claude Tool Use · Gemini Function Calling

🚀 Quick Start

1
Get an API Token
POST /api/ai/auth with your login email and password. Returns a t84_* token valid 7 days. Or generate a permanent key from your account settings.
2
Choose Your Platform
GPT Actions, Claude MCP, or direct REST API — all use the same OpenAPI spec at /api/openapi.json.
3
Start Searching
Call GET /api/ai/tenders/search with your Bearer token. Filter by state, dept, sector, value, keyword.

🔌 Platform Integration

🧠 ChatGPT (GPT Actions)
  1. Go to GPT Editor → Create New GPT
  2. Configure → Actions → Import from URL
  3. Paste: https://tender84.com/api/openapi.json
  4. Auth: API Key → Bearer → paste your t84_... token
  5. Save → your GPT can now search tenders!
🧪 Claude Web (MCP Custom Connector)

Easiest setup — no install required.

  1. Open Claude → Settings → Custom Connectors
  2. Add Connector → paste this URL:
https://tender84.com/mcp

Login with your Tender84 email+password via the tender84_login tool.

🔷 Claude API (Tool Use)

Use the OpenAPI spec to generate tool definitions for Anthropic's Messages API with tools parameter. Same endpoints, same auth.

Authorization: Bearer t84_...
🌐 Gemini (Google AI Studio)

Convert endpoint definitions from the OpenAPI spec into Gemini function declarations. Use the same Bearer token for auth.

📚 API Reference

Base URL: https://tender84.com · OpenAPI spec: /api/openapi.json

GET /api/ai/tenders/search

Search tenders by keyword, state, department, sector, value range, and status.

curl -H "Authorization: Bearer t84_YOUR_TOKEN" "https://tender84.com/api/ai/tenders/search?q=road+construction&state=rj&min_value=5000000&status=live&limit=5"

Parameters: q state dept sector min_value max_value status (live|all) limit (1-50)

GET /api/ai/tenders/{tender_id}

Full tender detail including value, EMD, dates, authority, and credit cost to request documents.

curl -H "Authorization: Bearer t84_YOUR_TOKEN" "https://tender84.com/api/ai/tenders/TENDER_ID"
POST /api/ai/tenders/{tender_id}/request-docs

Request PDF documents. Two-step: first call without confirm to see cost, then with "confirm": true to proceed.

# Step 1: Check cost
curl -X POST -H "Authorization: Bearer t84_YOUR_TOKEN" -H "Content-Type: application/json" -d '{}' "https://tender84.com/api/ai/tenders/TENDER_ID/request-docs"

# Step 2: Confirm
curl -X POST -H "Authorization: Bearer t84_YOUR_TOKEN" -H "Content-Type: application/json" -d '{"confirm":true}' "https://tender84.com/api/ai/tenders/TENDER_ID/request-docs"
GET /api/ai/account/balance

Check your credit balance and account info.

curl -H "Authorization: Bearer t84_YOUR_TOKEN" "https://tender84.com/api/ai/account/balance"
GET /api/ai/account/requests

View your document request history. Optional ?status=pending|processing|completed|rejected.

curl -H "Authorization: Bearer t84_YOUR_TOKEN" "https://tender84.com/api/ai/account/requests"
GET /api/ai/meta/states

List all available state and PSU portal codes for the search state parameter.

curl "https://tender84.com/api/ai/meta/states"

🔑 Authentication

All endpoints (except /api/ai/meta/states) require a Bearer token.

  1. Get a token: Call POST /api/ai/auth with your Tender84 email and password:
    curl -X POST -H "Content-Type: application/json" -d '{"email":"[email protected]","password":"***"}' https://tender84.com/api/ai/auth
    Returns { "token": "t84_...", "expires_in_days": 7 }
  2. Token format: Starts with t84_ — valid for 7 days
  3. Use in header: Authorization: Bearer t84_YOUR_TOKEN

For permanent keys, use the /api/ai/developer-keys API (requires a valid session token first).

💳 Credit System

Tender ValueCredits Required
Below ₹20 Lakh5 credits
₹20L – ₹50L9 credits
₹50L – ₹1Cr12 credits
₹1Cr – ₹5Cr15 credits
Above ₹5 Crore20 credits
GeM Tenders10 credits
OpenAPI spec: /api/openapi.json · MCP Server: tender84.com/mcp · Support: [email protected]