Input schema (JSON)
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 300
},
"cpv": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{2,8}$"
},
"maxItems": 50,
"description": "CPV code prefixes, such as 45 (construction work) or 72 (IT services). Matches notices whose source lists such a code.",
"uniqueItems": true
},
"page": {
"type": "integer",
"default": 1,
"maximum": 1000000,
"minimum": 1
},
"sort": {
"enum": [
"relevance",
"deadline",
"newest"
],
"type": "string",
"default": "relevance"
},
"view": {
"enum": [
"compact",
"full"
],
"type": "string",
"default": "compact",
"description": "compact returns what is needed to choose and cite a notice; full returns whole records (notice text, facts, history), at most 20 per page."
},
"buyer": {
"type": "string",
"maxLength": 100
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"place": {
"type": "string",
"maxLength": 100,
"minLength": 3,
"description": "Part of the place of performance or buyer location as published, such as Genève or Zürich. Spelling matters; many notices name only a region."
},
"locale": {
"enum": [
"en",
"de",
"fr"
],
"type": "string",
"default": "en"
},
"sectors": {
"type": "array",
"items": {
"enum": [
"construction",
"medical",
"it-telecoms",
"energy",
"environment",
"transport",
"facilities",
"food",
"engineering",
"consulting",
"education",
"office",
"culture",
"machinery",
"materials",
"agriculture"
],
"type": "string"
},
"maxItems": 16,
"description": "Broad sectors grouping every category and CPV code, such as construction or it-telecoms. Prefer this to category IDs for broad needs.",
"uniqueItems": true
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Currency of valueMin and valueMax, such as CHF or EUR. Only notices stating an estimated value in this currency match; amounts are not converted."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"open",
"closing-soon",
"closed",
"awarded",
"cancelled",
"suspended",
"upcoming",
"unconfirmed"
],
"type": "string"
},
"default": [
"closing-soon",
"open",
"unconfirmed",
"upcoming"
],
"maxItems": 8,
"description": "Omit for active statuses (open, closing-soon, upcoming, unconfirmed). An explicit empty array includes all statuses. closing-soon is an open notice whose deadline is within 7 days (168 hours); a passed deadline shows as closed. OR within each filter, AND between filters and text search.",
"uniqueItems": true
},
"valueMax": {
"type": "number",
"minimum": 0,
"description": "Highest estimated value; needs currency."
},
"valueMin": {
"type": "number",
"minimum": 0,
"description": "Lowest estimated value; needs currency."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"maxItems": 250,
"uniqueItems": true
},
"categories": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]{1,100}$"
},
"maxItems": 500,
"uniqueItems": true
},
"deadlineTo": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[0-9:.]+(Z|[+-]\\d{2}:\\d{2}))?$",
"maxLength": 40,
"description": "Latest submission deadline: an ISO date (to its end, UTC) or a time with a timezone. Notices without a deadline are excluded once either bound is set."
},
"deadlineFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T[0-9:.]+(Z|[+-]\\d{2}:\\d{2}))?$",
"maxLength": 40,
"description": "Earliest submission deadline: an ISO date (from its start, UTC) or a time with a timezone. Date-only deadlines count as the end of their day."
}
},
"additionalProperties": false
}