# getTendersByIds

**Identifier:** `tedeuropa_getTendersByIds`

**Provider:** [TED Europa](https://kirha.com/providers/tedeuropa.md)

Fetch detailed information for specific tenders from TED Europa by their IDs. Retrieves enriched data including full description, buyer information, estimated values, deadlines, and CPV codes from the tender XML. Supports up to 25 tender IDs per request.

## Run it with the CLI

```bash
kirha tools run tedeuropa_getTendersByIds \
  --input '{
    "tenderIds": [
      "<tenderIds>"
    ]
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "tedeuropa_getTendersByIds",
  "input": {
    "tenderIds": [
      "<tenderIds>"
    ]
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tenderIds": {
      "description": "List of tender IDs to fetch. Supports formats: '698103-2025' or '698103/2025'",
      "items": {
        "type": "string"
      },
      "maxItems": 25,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "tenderIds"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "data": {
      "additionalProperties": {
        "additionalProperties": false,
        "properties": {
          "awardDate": {
            "type": "string"
          },
          "awardedValue": {
            "type": "number"
          },
          "awardedValueCurrency": {
            "type": "string"
          },
          "buyerEmail": {
            "type": "string"
          },
          "buyerName": {
            "type": "string"
          },
          "buyerPhone": {
            "type": "string"
          },
          "buyerWebsite": {
            "type": "string"
          },
          "contractEndDate": {
            "type": "string"
          },
          "contractModificationValue": {
            "type": "number"
          },
          "contractReference": {
            "type": "string"
          },
          "contractStartDate": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "cpvCodes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "deadlineDate": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "estimatedValue": {
            "type": "number"
          },
          "estimatedValueCurrency": {
            "type": "string"
          },
          "fundingProgram": {
            "type": "string"
          },
          "htmlLink": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "modificationJustification": {
            "type": "string"
          },
          "modificationReason": {
            "type": "string"
          },
          "noticeType": {
            "type": "string"
          },
          "previousContractValue": {
            "type": "number"
          },
          "procedureType": {
            "type": "string"
          },
          "procurementLegislation": {
            "type": "string"
          },
          "publicationDate": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "totalContractValue": {
            "type": "number"
          },
          "totalContractValueCurrency": {
            "type": "string"
          },
          "xmlLink": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "xmlLink",
          "htmlLink"
        ],
        "type": "object"
      },
      "propertyNames": {
        "type": "string"
      },
      "type": "object"
    }
  },
  "required": [
    "context",
    "data"
  ],
  "type": "object"
}
```

-----

[All TED Europa tools](https://kirha.com/providers/tedeuropa.md) · [< Back to tools list](https://kirha.com/tools.md)