REST API Documentation

Introduction

The API is for advanced users that want to include the publications in a workflow or internal website. Get your api key per request. See contact contact
api

Authorization

  api_key = '<your api code>'
  headers = {
    'Authorization': 'Api-Key ' + api_key
  }  

Example (Python)

 
import requests

api_key = '<your api code>'
headers = {
    'Authorization': f'Api-Key {api_key}'
}

url = 'https://www.it-beschaffung.ch/api/publications/it/?ob_code=OB02'
response = requests.get(url, headers=headers)

print(response.json())

Commands

Get Publication List

GET /api/publications/{group}/?ob_code={ob_code}

Parameters

• group: required, string
  The code for the specific publication group. Valid values:
  • 'C': Consulting
  • 'CW': Construction Work
  • 'CT': Contracting
  • 'E': Electricity
  • 'AE': Architecture and Engineering
  • 'H': Health Care
  • 'IT': IT
  • 'L': Landscaping
  • 'P': Print
  • 'RW': Railway Systems
  • 'SY': Sanitary
  • 'SEC': Security Services
  • 'T': Transportation
  • 'V': Vehicles
  • 'W': Waste Management
  • 'HR': Personaldienstleistungen (HR, Recruiting, Verleih)
  • 'NA': not specified

Filters

• ob_code: optional, string
  The code for the specific publication type. Valid values:
  • 'OB00': Prepublications
  • 'OB01': Tenders
  • 'OB02': Awards
  • 'OB03': Prequalifications
  • 'OB05': Summaries
  • 'OB07': Competitions
  • 'OB08': Competition Awards
  • 'OB04': Cancellations
  • 'OB06': Corrections
  • 'OB09': Withdrawals
• date: optional, string
  The specific date to retrieve activities for. Format: `YYYY-MM-DD`. If not provided, the latest publications will be returned.
• days_back: optional, integer
  The number of days back from the date given to retrieve publications for. Default: 5. Maximum: 5

Responses

• HTTP code 200 - The publication's detailed representations. List of instances of Publication.
• HTTP code 4xx, 5xx - A Fault describing the reason for the error.

Sample Response

   https://www.it-beschaffung.ch/api/publications/it/?ob_code=OB02

[
  {
    'id_simap': 1344781,
    'ob_code': 'OB02',
    'category': 'Zuschlag',
    'title': 'Neues Rechenzentrum Stadt Biel',
    'text': 'Netrics AG hat die vorteilhafteste Offerte eingereicht.',
    'is_wto': True,
    'date': '2023-06-17',
    'procedure': 'offenes Verfahren',
    'lot_nr': None,
    'lots': '[]',
    'auth_activity': 'GENERAL_PUBLIC_SERVICES',
    'nr_of_offers': 2,
    'award_price': '904039.00',
    'award_companies': ['netrics AG']
  },
  {
    'id_simap': 1344279,
    'ob_code': 'OB02',
    'category': 'Zuschlag',
    'title': 'Talent Management Suite',
    'text': 'Das berücksichtigte Angebot erhielt für die Erfüllung der Zuschlagskriterien 838.5 von 1000.0 möglichen Punkten und hat damit am meisten Punkte erzielt. Die Zuschlagsempfängerin hat damit das vorteilhafteste Angebot eingereicht.',
    'is_wto': True,
    'date': '2023-06-17',
    'procedure': 'offenes Verfahren',
    'lot_nr': None,
    'lots': '[]',
    'auth_activity': 'HEALTH',
    'nr_of_offers': 6,
    'award_price': '1332480.00',
    'award_companies': ['FLOWIT AG']
  }
]

Get Publication

GET /api/publication/{id_simap}/

Parameters

• id_simap: required, integer
  The id for the specific publication.

Responses

• HTTP code 200 - The publication's detailed representation. Instances of Publication.
• HTTP code 4xx, 5xx - A Fault describing the reason for the error.

Sample Response

   https://www.it-beschaffung.ch/api/publication/1343713/

{
    "id_simap": 1343713,
    "ob_code": "OB02",
    "category": "Zuschlag",
    "title": "Rahmenvertragspartner SSK",
    "text": "Die 4 (vier) vorteilhaftesten Angebote erhalten den Zuschlag.\n\nDie für den Zuschlag massgebenden Merkmale und Vorteile der berücksichtigten Angebote (Art. 51 Abs. 3 Bst. c IVöB 2019) sind folgende:\n- Die berücksichtigten Angebote weisen eine hohe Leistungsfähigkeit auf und erfüllen die Anforderungen in hohem Ausmass. Ausschlaggebend für den Entscheid waren die überzeugenden Referenzprojekte sowie die umfangreichen Erfahrungen der angebotenen Berater der berücksichtigten Angebote im Steuerwesen in der Schweiz. \n- Die berücksichtigten Angebote erfüllten die Zuschlagskriterien am besten und erhielten damit am meisten Punkte der eingegangenen Angebote. Ihnen ist daher als vorteilhafteste Angebote der Zuschlag zu erteilen.",
    "is_wto": true,
    "date": "2023-06-14",
    "procedure": "offenes Verfahren",
    "lot_nr": null,
    "lots": "[]",
    "auth_activity": "ECONOMIC_AND_FINANCIAL_AFFAIRS",
    "nr_of_offers": 6,
    "award_price": "12264000.00",
    "award_companies": [
        "ANMA Consulting AG",
        "couniq consulting AG",
        "Deloitte Consulting AG",
        "Eraneos Switzerland AG"
    ],
    "id": 114940,
    "language_code": "de",
    "bund_nr": null,
    "procurement": "OTHER",
    "auth_sector": "NO",
    "auth_category": "C",
    "auth_city": 705,
    "auth_canton": "BE",
    "auth_country": "CH",
    "date_doc_availble_start": null,
    "date_doc_availble_end": null,
    "date_questions": null,
    "datetime_deadline": null,
    "datetime_opening": null,
    "date_project_start": null,
    "date_project_end": null,
    "award_date": "2023-05-16",
    "prior_id_simap": null,
    "prior_ob_code": null,
    "prior_date": "2023-01-20",
    "prior_puborgan": "www.simap.ch",
    "project": null,
    "reason_no_offer": null,
    "reason_conditions_changed": null,
    "reason_major_project_change": null,
    "reason_text": null,
    "groups": [
        "IT"
    ],
    "cpvs": [
        "IT-Dienste: Beratung, Software-Entwicklung, Internet und Hilfestellung",
        "Softwareprogrammierung und -beratung",
        "Beratung im Bereich Projektleitung",
        "Systemberatung und technische Beratung"
    ]
}