RhinoTenders APIBETA

Consume the tenders catalogue programmatically, within your own subscription plan.

Documentation for AI agents (.txt)
RhinoTenders API & integrations
Environment
Base URLhttps://api.rhinotenders.com/api/v1/data

Introduction

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.

CriterionProductionSandbox
Base URLhttps://api.rhinotenders.com/api/v1/datahttps://api.rhinotenders.com/api/v1/sandbox
TokenLong-lived token, valid 1 year (name: api-client).Disposable token, valid 24 hours (name: api-sandbox). One active token per account.
How to get itGenerated 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.
DataThe full catalogue granted by your subscription.A limited set of real tenders, to test your integration.
Quota and subscriptionPer subscription plan: tender detail calls consume quota.None. The subscription and quota fields keep the same shape, with null values.
Rate limit15 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 filtersAvailable 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 markerHeader X-Api-Environment: production. GET /status returns data.environment = "production".Header X-Api-Environment: sandbox. GET /status returns data.environment = "sandbox".
Wrong tokenA 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

GET/api/v1/data/status

Checks 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

GET/api/v1/data/tenders

Returns 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_idA single tender ID — bypasses all other filters.
tender_idsMultiple comma-separated IDs — bypasses all other filters.
searchText search (title, code).
activity_idActivity ID(s), comma-separated.
location_idLocation ID(s), comma-separated.
status_idStatus ID(s), comma-separated.
organism_idOrganization ID(s) — advanced filter, ignored if not granted by your plan, always ignored in sandbox.
tender_typeNational, International, or both comma-separated.
publish_date_start / publish_date_endPublish date range (YYYY-MM-DD).
ending_date_start / ending_date_endEnd date range — advanced filter, ignored if not granted by your plan, always ignored in sandbox.
page / per_pagePagination — 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

GET/api/v1/data/tenders/filters

Reference 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

GET/api/v1/data/organizations

Search 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.

qSearch by name, accent/case-insensitive.
page / per_pagePagination — 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

GET/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

StatusMeaning
401Missing, 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.
404Tender not found, not accessible, or invalid route.
422Invalid request parameters (detail in errors).
429Rate 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.

Choose the cookie categories you want to enable. You can change your choices at any time.

Strictly necessary

Always on

Essential for the site to function (authentication, security). Cannot be disabled.

Analytics

Help us understand how you use the site (visit statistics, performance).

Marketing

Allow us to show relevant ads and measure campaign effectiveness.

Preferences

Remember your language, region, and display personalization choices.

Partners

Cookies set by our third-party partners (social networks, external integrations).