tenderapi-fr

tenderapi-fr Renewals API

The renewals API from tenderapi-fr — 1 operation(s) for renewals.

GitHub OpenAPI

Operations 1

GET /renewals Search Renewals #

Documentation

📖
Documentation
https://tenderapi.fr/docs
📖
APIReference
https://tenderapi.fr/openapi.json

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tenderapi-fr/openapi/tenderapi-fr-renewals-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-award-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-tender-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-profile-preview-in-schema.json
📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-profile-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-profile-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/tenderapi-fr/json-schema/tenderapi-fr-me-out-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tenderapi-fr:tenderapi-fr-renewals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tenderapi-fr-renewals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tender Renewals API
  description: Unified French (BOAMP) + EU (TED) public procurement intelligence API. Search tenders, track award outcomes, discover winner patterns.
  version: 1.0.0
tags:
- name: renewals
paths:
  /renewals:
    get:
      tags:
      - renewals
      summary: Search Renewals
      description: 'Contracts whose **declared** end date falls in a window ahead of today, i.e.

        likely to be put back out to tender. Source: DECP (data.gouv.fr), refreshed

        weekly. Sorted by end date, soonest first. **Rows require the pro tier.**'
      operationId: search_renewals_renewals_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: department
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Department code(s) of the place of EXECUTION, e.g. 83 or 83,06
          title: Department
        description: Department code(s) of the place of EXECUTION, e.g. 83 or 83,06
      - name: cpv
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: '8-digit CPV code(s), exact match: repeat or comma-separate'
          title: Cpv
        description: '8-digit CPV code(s), exact match: repeat or comma-separate'
      - name: cpv_family
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: 2-digit CPV family code(s), e.g. 45 (works), 90 (cleaning, waste)
          title: Cpv Family
        description: 2-digit CPV family code(s), e.g. 45 (works), 90 (cleaning, waste)
      - name: buyer_siret
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: SIRET (14 digits) of the public buyer
          title: Buyer Siret
        description: SIRET (14 digits) of the public buyer
      - name: buyer_keyword
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Partial, case-insensitive match on the buyer name (3 characters minimum). Alias: buyer_name'
          title: Buyer Keyword
        description: 'Partial, case-insensitive match on the buyer name (3 characters minimum). Alias: buyer_name'
      - name: min_months
        in: query
        required: false
        schema:
          type: integer
          maximum: 36
          minimum: 0
          description: Declared end date at least this many months from today (default 3)
          default: 3
          title: Min Months
        description: Declared end date at least this many months from today (default 3)
      - name: max_months
        in: query
        required: false
        schema:
          type: integer
          maximum: 36
          minimum: 1
          description: Declared end date at most this many months from today (default 18, max 36)
          default: 18
          title: Max Months
        description: Declared end date at most this many months from today (default 18, max 36)
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          default: 1
          title: Page
      - name: page_size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Page Size
      - name: limit
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 100
            minimum: 1
          - type: 'null'
          description: Alias for page_size. If both are passed, limit wins.
          title: Limit
        description: Alias for page_size. If both are passed, limit wins.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RenewalListOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RenewalOut:
      properties:
        id:
          type: integer
          title: Id
        buyer_siret:
          type: string
          title: Buyer Siret
        buyer_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Buyer Name
        objet:
          anyOf:
          - type: string
          - type: 'null'
          title: Objet
        nature:
          anyOf:
          - type: string
          - type: 'null'
          title: Nature
        procedure:
          anyOf:
          - type: string
          - type: 'null'
          title: Procedure
        cpv:
          anyOf:
          - type: string
          - type: 'null'
          title: Cpv
        amount:
          anyOf:
          - type: number
          - type: 'null'
          title: Amount
        winners:
          items:
            $ref: '#/components/schemas/RenewalWinner'
          type: array
          title: Winners
          default: []
        offers_received:
          anyOf:
          - type: integer
          - type: 'null'
          title: Offers Received
        department:
          anyOf:
          - type: string
          - type: 'null'
          title: Department
        region:
          anyOf:
          - type: string
          - type: 'null'
          title: Region
        notified_at:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: Notified At
        duration_months:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Months
        end_date:
          anyOf:
          - type: string
            format: date
          - type: 'null'
          title: End Date
        platform:
          anyOf:
          - type: string
          - type: 'null'
          title: Platform
      type: object
      required:
      - id
      - buyer_siret
      - buyer_name
      - objet
      - nature
      - procedure
      - cpv
      - amount
      - offers_received
      - department
      - region
      - notified_at
      - duration_months
      - end_date
      - platform
      title: RenewalOut
    RenewalListOut:
      properties:
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        ends_after:
          type: string
          format: date
          title: Ends After
        ends_before:
          type: string
          format: date
          title: Ends Before
        results:
          items:
            $ref: '#/components/schemas/RenewalOut'
          type: array
          title: Results
        notice:
          type: string
          title: Notice
          default: 'Échéance déclarée, reconductions possibles : end_date = date de notification + durée déclarée dans les DECP. Selon l''acheteur, cette durée inclut ou non les reconductions.'
        hint:
          anyOf:
          - type: string
          - type: 'null'
          title: Hint
        client_update:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Update
        locked:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Locked
        upgrade:
          anyOf:
          - type: string
          - type: 'null'
          title: Upgrade
      type: object
      required:
      - total
      - page
      - page_size
      - ends_after
      - ends_before
      - results
      title: RenewalListOut
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    RenewalWinner:
      properties:
        siret:
          type: string
          title: Siret
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
      type: object
      required:
      - siret
      title: RenewalWinner
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key