RhinoTenders APIBETA
Consume the tenders catalogue programmatically, within your own subscription plan.
Documentation for AI agents (.txt)https://api.rhinotenders.com /api/v1/dataIntroduction
The RhinoTenders Data API lets your own integrations pull the tenders catalogue you already have access to through your subscription: status check, list, filters, organizations and tender details.
It is a read-only REST API (all endpoints are GET). Access must be enabled by a RhinoTenders admin for your account, then you generate your own token from your API dashboard.
No production access yet? Any account with a completed profile can try the API right away in the sandbox, without a subscription — see Sandbox vs Production.
Authentication
Every request must include your token as a Bearer token in the Authorization header:
Authorization: Bearer <your_token>Your token is shown only once when generated (or regenerated) from the dashboard — store it securely, it cannot be retrieved again.
Sandbox vs Production
The sandbox lets you build and test an integration without touching production: try the endpoints, debug your code, or hand a disposable token to a developer or contractor instead of sharing your production token.
Generate a sandbox token yourself from your API dashboard: any account with a completed profile can, no subscription and no admin approval needed. The token is valid for 24 hours and each account has only one active sandbox token: generating a new one immediately invalidates the previous one.
Both environments expose exactly the same endpoints, parameters and response shapes: only the base URL and the token change. Switching environment is a configuration change, not a code change.
| Criterion | Production | Sandbox |
|---|---|---|
| Base URL | https://api.rhinotenders.com | https://api.rhinotenders.com |
| Token | Long-lived token, valid 1 year (name: api-client). | Disposable token, valid 24 hours (name: api-sandbox). One active token per account. |
| How to get it | Generated from your API dashboard once a RhinoTenders admin has enabled API access for your account. Requires an active subscription. | Self-service from your API dashboard, for any account with a completed profile, regardless of subscription. |
| Data | The full catalogue granted by your subscription. | A limited set of real tenders, to test your integration. |
| Quota and subscription | Per subscription plan: tender detail calls consume quota. | None. The subscription and quota fields keep the same shape, with null values. |
| Rate limit | 15 requests/minute, and per day 750 requests (free plan) or 2500 requests (paid plan). | 10 requests/minute and 250 requests/day (counters separate from production). |
| Premium filters | Available depending on your plan (hasAdvancedFilters). | Not available: organism_id, ending_date_start, ending_date_end are accepted but silently ignored, and hasAdvancedFilters is always false. |
| Environment marker | Header X-Api-Environment: production. GET /status returns data.environment = "production". | Header X-Api-Environment: sandbox. GET /status returns data.environment = "sandbox". |
| Wrong token | A sandbox token sent to this base URL returns 401 wrong_environment. | A production token sent to this base URL returns 401 wrong_environment. |
Response — Sandbox token sent to the Production base URL (401)
{
"success": false,
"message": "This is a sandbox token. Use the sandbox base URL (/api/v1/sandbox).",
"code": "wrong_environment"
}Status
/api/v1/data/statusChecks that your token is valid and returns, in a single call, the environment (data.environment: production or sandbox) and your api access, subscription and quota status. Useful to verify your integration. Free to call, does not consume any quota.
Request
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/status"Response
{
"success": true,
"data": {
"environment": "production",
"token": { "name": "api-client", "created_at": "2026-08-01T10:00:00Z", "expires_at": "2027-08-01T10:00:00Z" },
"api_access": { "active": true },
"subscription": { "plan": "Standard", "status": "active" },
"quota": {
"daily": { "limit": 100, "used": 7, "remaining": 93, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}
}List tenders
/api/v1/data/tendersReturns the tenders matching the given filters. Same parameters as the site search (text search, activity, location, status, type, organization, dates). Advanced filters (organization, end date) are silently ignored if your plan doesn't grant access to them, and always in sandbox — never an error. Free to call, consumes no quota, but in production it is blocked (403) if your subscription isn't active or your view quota is already exhausted.
| tender_id | A single tender ID — bypasses all other filters. |
| tender_ids | Multiple comma-separated IDs — bypasses all other filters. |
| search | Text search (title, code). |
| activity_id | Activity ID(s), comma-separated. |
| location_id | Location ID(s), comma-separated. |
| status_id | Status ID(s), comma-separated. |
| organism_id | Organization ID(s) — advanced filter, ignored if not granted by your plan, always ignored in sandbox. |
| tender_type | National, International, or both comma-separated. |
| publish_date_start / publish_date_end | Publish date range (YYYY-MM-DD). |
| ending_date_start / ending_date_end | End date range — advanced filter, ignored if not granted by your plan, always ignored in sandbox. |
| page / per_page | Pagination — per_page defaults to 20, capped at 100. |
Request
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders?page=1&per_page=20&activity_id=12000000"Response
{
"success": true,
"data": [
{
"id": 1490301,
"title": "Etude et suivi realisation de 4 classes en extention",
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel" },
"status": { "id": 4, "name": "Résultats" },
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z"
}
],
"meta": { "current_page": 1, "per_page": 20, "total": 187 }
}Filter data
/api/v1/data/tenders/filtersReference data to build your filters: activities, statuses, locations, types. A single complete object (no pagination), server-cached for 1-2h. hasAdvancedFilters reflects your subscription plan (always false in sandbox).
Request
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders/filters"Response
{
"success": true,
"data": {
"locations": [{ "id": 20, "name": "Jijel", "type": "wilaya", "flag": null, "country_name": "Algérie" }],
"statuses": [{ "id": 4, "name": "Résultats" }],
"activities": [{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }],
"types": [
{ "value": "National", "label": "National" },
{ "value": "International", "label": "International" }
],
"hasAdvancedFilters": true
}
}Organizations
/api/v1/data/organizationsSearch organizations by name (q, accent/case-insensitive) to resolve an organism_id for the tenders list filter, or paginate through all of them to sync the directory. Only organizations that have published at least one tender — never the full internal directory.
| q | Search by name, accent/case-insensitive. |
| page / per_page | Pagination — per_page defaults to 50, capped at 500. |
Request
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/organizations?q=education&per_page=50"Response
{
"success": true,
"data": [
{ "id": 42, "name": "Ministère de l'Éducation" }
],
"meta": { "current_page": 1, "per_page": 50, "total": 3 }
}Tender detail
/api/v1/data/tenders/{id}Full tender detail. In production, consumes one unit of your subscription quota — the exact same quota as browsing the tender on the website (a tender viewed once, via the API or the site, is not counted twice within 12 months). "Online consultation" tenders and tenders expired for more than 10 days do not consume quota, but remain subject to the same access rules: no exception if your subscription is inactive or your quota is already exhausted. The response shape depends on the tender's status (see the two examples below). In sandbox, no quota is consumed and quota fields are null. Standard tenders include sources: the publication sources of the official notice (source name and image_url, a direct link to the scanned image, accessible without a token). The description field holds the full notice text in two versions: html (structure only, already sanitized server-side: no scripts, links, images or styles) and text (plain text). Render text as text (textContent), never as HTML; if you render html in a page, sanitize it on your side as well (e.g. DOMPurify). generated is true when the original text is too large and has been replaced by a summary generated from the tender fields (details remain in lots and sources). description is null when the tender has no text.
Request
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders/1490301"Response — Standard tender
{
"success": true,
"data": {
"id": 1490301,
"slug": "etude-et-suivi-realisation-de-4-classes-en-extention",
"title": "Etude et suivi realisation de 4 classes en extention",
"code": "07/2026",
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z",
"is_expired": true,
"status": { "id": 4, "name": "Résultats" },
"tender_type": "National",
"qualification": null,
"address_cdc": "Étude de Maître Belhadj Ali, huissier de justice, Boumerdès",
"cdc_price": { "amount": "16000000.00", "currency": "DZD" },
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel", "type": "wilaya", "country_id": 2 },
"activities": [
{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }
],
"lots": [
{
"id": 536288,
"name": "Etude et suivi realisation de 4 classes en extention",
"entreprise": "Entreprise travaux batiment Beldjoudi Samir",
"nif": null,
"montant": "22730697.89",
"devise": "DZD",
"delai": 5,
"delai_unit": "m",
"order": 0
}
],
"description": {
"html": "<p><strong>AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ</strong></p><p>APC d'El Milia</p><table><tr><th>Lot</th><th>Attributaire</th></tr><tr><td>1</td><td>Entreprise Beldjoudi Samir</td></tr></table>",
"text": "AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ\n\nAPC d'El Milia\n\nLot | Attributaire\n1 | Entreprise Beldjoudi Samir",
"generated": false
},
"sources": [
{
"name": "BAOSEM",
"image_url": "https://storage.rhinotenders.com/tenders/sources/rh-ai-xorGHcEaL5sOUlpX1791965524.webp"
}
]
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Response — Online consultation (status 9)
{
"success": true,
"data": {
"id": 1487429,
"slug": "invitation-to-competitive-bidding-projet-ao-202677-058",
"title": "Invitation to Competitive Bidding | Projet AO_2026/77_058",
"publish_date": "2026-09-07",
"ending_date": "2026-09-30T23:45:00Z",
"is_expired": false,
"organism": { "id": 19321, "name": "General Electric Algeria Turbines (« GEAT »)" },
"location": { "id": 2, "name": "Algérie" },
"status": { "id": 9, "name": "Consultation en ligne" },
"activities": [
{ "id": 7182, "name": "[40180000] - Tubes et raccords" }
],
"description": {
"html": "<p>Fourniture de tubes et raccords selon le cahier des charges joint.</p>",
"text": "Fourniture de tubes et raccords selon le cahier des charges joint.",
"generated": false
}
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Error codes
| Status | Meaning |
|---|---|
| 401 | Missing, invalid, expired or revoked token (generic message, never distinguished). |
| 401 (wrong_environment) | Token used in the wrong environment: a sandbox token on the production base URL (/api/v1/data) or the reverse. The message tells you which base URL to use. |
| 403 (api_access_disabled) | API access disabled for this account by an administrator, or a token that was not generated for this API. |
| 403 (token_scope_violation) | Data API token (production or sandbox) used outside the data API: it only works on the endpoints documented here. |
| 403 (subscription_inactive) | No active subscription grants access to the catalogue. Your token is revoked immediately: a new one can only be generated once your subscription is active again. |
| 403 (quota_exceeded) | Subscription quota exhausted for tender views. |
| 404 | Tender not found, not accessible, or invalid route. |
| 422 | Invalid request parameters (detail in errors). |
| 429 | Rate limit exceeded (15 requests/minute and 750 or 2500 requests/day depending on your plan in production; 10 requests/minute or 250 requests/day in sandbox). |
Rate limits
In addition to your subscription quota (which only applies to tender detail calls in production), a technical rate limit protects the API from abuse: 15 requests per minute in production, capped at 750 requests per day on the free plan and 2500 requests per day on a paid plan, 10 requests per minute and 250 requests per day in sandbox.
Each limit is shared across all endpoints of an environment for your account (not a separate limit per endpoint), and the production (/api/v1/data) and sandbox (/api/v1/sandbox) counters are independent. Every response includes the X-RateLimit-Limit and X-RateLimit-Remaining headers of the limit closest to being reached (per minute, or per day as the daily cap approaches); a 429 response also includes Retry-After (in seconds). Avoid re-fetching the same tenders in a loop: query the list, then only fetch the details of new tenders.
