{"openapi":"3.1.0","info":{"title":"External API","description":"API for external consumption.\n\n**Authentication:**\nTo use this API, you must obtain an API Token. Log in to Tenderwell, navigate to the Developers page from the Profile menu and generate a new API Key.\n\nYou must be the team owner and your plan must have API_ACCESS enabled to be able to access the Developers page and create API keys.\n\nProvide this token in the `X-API-KEY` HTTP header for all requests."},"servers":[{"url":"https://tenderwell.com","description":"Generated server url"}],"security":[{"X-API-KEY":[]}],"paths":{"/api/external/tenders/search":{"post":{"tags":["external-tender-controller"],"summary":"Search tenders","description":"Search tenders using various filters. For `placeOfOrigin` and `placeOfPerformance`, \n                         you can use ISO 3166-1 alpha-2 country codes only. Regions and custom regions are \n                         defined as groups of country codes","operationId":"search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalTenderSearchFilter"}}},"required":true},"responses":{"200":{"description":"Successful search","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalTenderSearchResult"}}}},"400":{"description":"Bad Request - Core search error or request validation error","content":{"*/*":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CoreApiErrorResponse"},{"$ref":"#/components/schemas/ExternalErrorResponse"}]},"examples":{"coreSearchBadRequest":{"summary":"Core search error","description":"coreSearchBadRequest","value":{"traceId":"8c5f2c9f4b1a4df2","data":[{"code":"SEARCH_INVALID_QUERY","message":"Search filter or query is not valid for the search service."}]}},"requestValidationBadRequest":{"summary":"Request validation error","description":"requestValidationBadRequest","value":{"error":{"message":"page: must be greater than or equal to 1"}}}}}}},"401":{"description":"Unauthorized - Missing API key","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Missing API key"}}}}},"403":{"description":"Forbidden - Invalid API key or insufficient permissions","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Invalid API key"}}}}},"429":{"description":"Too Many Requests - Plan quota exceeded or API request rate limit exceeded","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"examples":{"planQuotaExceeded":{"summary":"Plan quota exceeded","description":"planQuotaExceeded","value":{"error":{"message":"API search limits exceeded"}}},"rateLimitExceeded":{"summary":"API request rate limit exceeded","description":"rateLimitExceeded","value":{"error":{"message":"Rate limit exceeded. You are in a cooldown period."}}}}}}}}}},"/api/external/tenders/{tenderId}":{"get":{"tags":["external-tender-controller"],"summary":"Get tender details by ID","description":"Retrieve comprehensive information about a specific tender.","operationId":"getTender","parameters":[{"name":"tenderId","in":"path","description":"The unique identifier of the tender","required":true,"schema":{"type":"integer","format":"int64"},"example":2309146}],"responses":{"200":{"description":"Tender details found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalTender"}}}},"400":{"description":"Bad Request - Invalid tender ID format","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Bad request"}}}}},"401":{"description":"Unauthorized - Missing API key","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Missing API key"}}}}},"403":{"description":"Forbidden - Invalid API key or insufficient permissions","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Invalid API key"}}}}},"404":{"description":"Tender not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Tender not found"}}}}},"429":{"description":"Too Many Requests - Plan quota exceeded or API request rate limit exceeded","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"examples":{"planQuotaExceeded":{"summary":"Plan quota exceeded","description":"planQuotaExceeded","value":{"error":{"message":"API search limits exceeded"}}},"rateLimitExceeded":{"summary":"API request rate limit exceeded","description":"rateLimitExceeded","value":{"error":{"message":"Rate limit exceeded. You are in a cooldown period."}}}}}}}}}},"/api/external/tenders/{tenderId}/documents/download/{documentId}":{"get":{"tags":["external-tender-controller"],"summary":"Download document","description":"Download a document associated with the tender.","operationId":"downloadDocument","parameters":[{"name":"tenderId","in":"path","description":"The unique identifier of the tender","required":true,"schema":{"type":"integer","format":"int64"},"example":2309146},{"name":"documentId","in":"path","description":"The unique identifier of the document","required":true,"schema":{"type":"integer","format":"int64"},"example":39323822}],"responses":{"200":{"description":"Document download started"},"400":{"description":"Bad Request - Invalid ID format or document is external","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Cannot download documents of type 'External' via the API."}}}}},"401":{"description":"Unauthorized - Missing API key","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Missing API key"}}}}},"403":{"description":"Forbidden - Invalid API key or insufficient permissions","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Invalid API key"}}}}},"404":{"description":"Tender or document not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"example":{"error":{"message":"Document not found: documentId=... tenderId=..."}}}}},"429":{"description":"Too Many Requests - Plan quota exceeded or API request rate limit exceeded","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExternalErrorResponse"},"examples":{"planQuotaExceeded":{"summary":"Plan quota exceeded","description":"planQuotaExceeded","value":{"error":{"message":"API search limits exceeded"}}},"rateLimitExceeded":{"summary":"API request rate limit exceeded","description":"rateLimitExceeded","value":{"error":{"message":"Rate limit exceeded. You are in a cooldown period."}}}}}}}}}},"/api/external/dictionaries/tendersortfields":{"get":{"tags":["external-dictionary-controller"],"summary":"List of tendersortfields","description":"List of tendersortfields","operationId":"getTenderSortFields","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SortFieldsResponse"}}}}}}}},"/api/external/dictionaries/statuses":{"get":{"tags":["external-dictionary-controller"],"summary":"List of statuses","description":"List of statuses","operationId":"getStatuses","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusResponse"}}}}}}}},"/api/external/dictionaries/sectors":{"get":{"tags":["external-dictionary-controller"],"summary":"List of sectors","description":"List of sectors","operationId":"getSectors","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SectorDto"}}}}}}}},"/api/external/dictionaries/sectors/full":{"get":{"tags":["external-dictionary-controller"],"summary":"List of full sectors","description":"List of full sectors","operationId":"getFullSectors","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FullSectorDto"}}}}}}}},"/api/external/dictionaries/regions":{"get":{"tags":["external-dictionary-controller"],"summary":"List of regions","description":"List of regions","operationId":"getRegions","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RegionDto"}}}}}}}},"/api/external/dictionaries/organizationsortfields":{"get":{"tags":["external-dictionary-controller"],"summary":"List of organizationsortfields","description":"List of organizationsortfields","operationId":"getOrganizationSortFields","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SortFieldsResponse"}}}}}}}},"/api/external/dictionaries/organization-types":{"get":{"tags":["external-dictionary-controller"],"summary":"List of organization types","description":"List of organization types","operationId":"getOrganizationTypes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationTypeResponse"}}}}}}}},"/api/external/dictionaries/currency":{"get":{"tags":["external-dictionary-controller"],"summary":"List of currency","description":"List of currency","operationId":"getCurrency","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyResponse"}}}}}}}},"/api/external/dictionaries/countries":{"get":{"tags":["external-dictionary-controller"],"summary":"List of countries","description":"List of countries","operationId":"getCountries","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}}}}}},"/api/external/dictionaries/contract-types":{"get":{"tags":["external-dictionary-controller"],"summary":"List of contract types","description":"List of contract types","operationId":"getContractTypes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ContractTypeDto"}}}}}}}}},"components":{"schemas":{"ExternalTenderSearchFilter":{"type":"object","description":"Filter for searching tenders","properties":{"page":{"type":"integer","format":"int32","default":1,"description":"Page number (starts from 1)","example":1,"minimum":1},"pageSize":{"type":"integer","format":"int32","default":10,"description":"Number of items per page. The maximum allowed page size is 300.","example":10,"maximum":300,"minimum":1},"sortBy":{"type":["array","null"],"description":"Fields to sort by. Available fields: BUDGET, CREATE_DATE, DEADLINE, PUBLICATION_DATE, RELEVANCE, STATUS, TITLE, UPDATE_DATE.","example":["STATUS"],"items":{"type":"string"}},"sortOrder":{"type":["array","null"],"description":"Sort order for each field in sortBy. Available values: ASC, DESC.","example":["DESC"],"items":{"type":"string"}},"freetext":{"type":["string","null"],"description":"Full-text search keyword","example":"software"},"status":{"type":["array","null"],"description":"Filter by tender status. Available values: FORECAST, OPEN, CLOSED, AWARDED, CANCELLED.","example":["OPEN"],"items":{"type":"string"}},"sectors":{"type":["array","null"],"description":"Filter by CPV sector codes","example":["72000000"],"items":{"type":"string"}},"sectorsNull":{"type":["boolean","null"],"default":false,"description":"If true, includes in the results the tenders with unknown sectors"},"placeOfOrigin":{"type":["array","null"],"description":"Filter by place of origin. Accepts ISO 3166-1 alpha-2 country codes (e.g., US) or custom region IDs. See the full list of region IDs in the API description.","example":["US","region_eu-27"],"items":{"type":"string"}},"placeOfOriginNull":{"type":["boolean","null"],"default":false,"description":"If true, includes in the results the tenders with unknown place of origin"},"placeOfPerformance":{"type":["array","null"],"description":"Filter by place of performance. Accepts ISO 3166-1 alpha-2 country codes (e.g., US) or custom region IDs. See the full list of region IDs in the API description.","example":["US","GB","region_asia"],"items":{"type":"string"}},"placeOfPerformanceNull":{"type":["boolean","null"],"default":false,"description":"If true, includes in the results the tenders with unknown place of performance"},"budgetMin":{"type":["number","null"],"format":"double","description":"Minimum budget value","example":1000.0},"budgetMax":{"type":["number","null"],"format":"double","description":"Maximum budget value","example":50000.0},"budgetNull":{"type":["boolean","null"],"default":false,"description":"If true, includes in the results the tenders with unknown budget"},"updatedFrom":{"type":["string","null"],"format":"date","description":"Filter tenders updated from this date (inclusive). Format: YYYY-MM-DD","example":"2026-01-01"},"updatedUntil":{"type":["string","null"],"format":"date","description":"Filter tenders updated until this date (inclusive). Format: YYYY-MM-DD","example":"2026-12-31"},"deadlineFrom":{"type":["string","null"],"format":"date","description":"Filter tenders with deadline from this date (inclusive). Format: YYYY-MM-DD","example":"2026-01-01"},"deadlineUntil":{"type":["string","null"],"format":"date","description":"Filter tenders with deadline until this date (inclusive). Format: YYYY-MM-DD","example":"2026-12-31"},"hasDeadline":{"type":["boolean","null"],"description":"Filter by presence of a deadline. Accepted values: true - inlcude only results that have a known deadline, false - return only results that have an unknown deadline, null - include results regardless of presence deadline"},"publicationFrom":{"type":["string","null"],"format":"date","description":"Filter tenders published from this date (inclusive). Format: YYYY-MM-DD","example":"2026-01-01"},"publicationUntil":{"type":["string","null"],"format":"date","description":"Filter tenders published until this date (inclusive). Format: YYYY-MM-DD","example":"2026-12-31"},"contractTypes":{"type":["array","null"],"description":"Filter by contract types. Available values: WORKS, GOODS, SERVICES, CONSTRUCTION, COMBINED, OTHERS, CONSULTANCY_SERVICES, UNKNOWN.","example":["SERVICES"],"items":{"type":"string"}}}},"CoreApiErrorMessage":{"type":"object","description":"Error details returned by the core API","properties":{"code":{"type":["string","null"],"description":"Machine-readable core API error code","enum":["UNKNOWN_ERROR","ENTITY_NOT_FOUND","REQUEST_VALIDATION_ERROR","REQUEST_PARSING_ERROR","DOCUMENT_VALIDATION_ERROR","SEARCH_ENGINE_ERROR","SEARCH_INVALID_QUERY","SEARCH_TIMEOUT_ERROR"],"example":"SEARCH_INVALID_QUERY"},"message":{"type":["string","null"],"description":"Human-readable error message","example":"Search filter or query is not valid for the search service."}}},"CoreApiErrorResponse":{"type":"object","description":"Structured error response returned by the core API","properties":{"traceId":{"type":["string","null"],"description":"Trace ID of this request in the sales portal. Quote this when reporting an issue.","example":"f47ac10b-58cc-4372-a567-0e02b2c3d479"},"coreTraceId":{"type":["string","null"],"description":"Trace ID assigned by the core API","example":"8c5f2c9f4b1a4df2"},"data":{"type":"array","description":"Error details returned by the core API","items":{"$ref":"#/components/schemas/CoreApiErrorMessage"}}}},"ErrorMessage":{"type":"object","description":"Error message container","properties":{"message":{"type":"string","description":"A human-readable error message","example":"Invalid API key"}}},"ExternalErrorResponse":{"type":"object","description":"Standard error response format for the external API","properties":{"error":{"$ref":"#/components/schemas/ErrorMessage","description":"Error details"}}},"Country":{"type":"object","description":"Country information","properties":{"code":{"type":"string","description":"ISO 3166-1 alpha-2 country code","example":"US"},"name":{"type":"string","description":"Full name of the country","example":"United States"}}},"ExternalTenderSearchResult":{"type":"object","description":"Result of a tender search","properties":{"totalResults":{"type":"integer","format":"int64","description":"Total number of tenders matching the filter","example":150},"page":{"type":["integer","null"],"format":"int32","description":"Current page number","example":1},"perPage":{"type":["integer","null"],"format":"int32","description":"Number of items per page","example":10},"sortedBy":{"type":["array","null"],"description":"Information about applied sorting","items":{"$ref":"#/components/schemas/SortedBy"}},"items":{"type":"array","description":"List of tender search results (summary version)","items":{"$ref":"#/components/schemas/TenderItem"}}}},"Sector":{"type":"object","description":"CPV sector code and name","properties":{"code":{"type":"string","description":"CPV code","example":"33100000"},"name":{"type":"string","description":"Human-readable name of the sector","example":"Medical equipments"}}},"SortedBy":{"type":"object","description":"Sorting details","properties":{"field":{"type":"string","description":"Field name","example":"STATUS"},"order":{"type":"string","description":"Sort order (ASC, DESC)","example":"DESC"}}},"TenderBudgetResponse":{"type":"object","description":"Budget information of a tender","properties":{"amount":{"type":["number","null"],"format":"double","description":"Numerical value of the budget amount","example":450000.0},"currency":{"type":["string","null"],"description":"Currency of the budget amount","example":"USD"}}},"TenderItem":{"type":"object","description":"Summary information about a tender in search results","properties":{"id":{"type":"string","description":"Unique identifier","example":"2309146"},"url":{"type":"string","description":"Direct URL to the tender in the portal","example":"https://tenderwell.com/tender/2309146"},"title":{"type":"string","description":"Title of the tender"},"sectors":{"type":"array","description":"List of associated CPV sectors","items":{"$ref":"#/components/schemas/Sector"}},"deadlineDate":{"type":["string","null"],"description":"Deadline date in ISO 8601 format","example":"2026-12-31T23:59:59Z"},"status":{"type":["string","null"],"description":"Current status of the tender","example":"OPEN"},"placeOfOrigin":{"description":"Country of origin","oneOf":[{"$ref":"#/components/schemas/Country"},{"type":"null"}]},"createdDate":{"type":["string","null"],"description":"Creation date in YYYY-MM-DD HH:mm:ss format","example":"2026-10-20 09:00:00"},"publicationDate":{"type":["string","null"],"description":"Original publication date","example":"2026-10-20"},"lastUpdateDate":{"type":["string","null"],"description":"Last update date in YYYY-MM-DD HH:mm:ss format","example":"2026-10-27 14:30:00"},"budgetCurrency":{"type":["string","null"],"deprecated":true,"description":"Budget currency","example":"EUR"},"budgetValue":{"type":["string","null"],"deprecated":true,"description":"Budget value as a string","example":"500000.0"},"baseBudget":{"description":"Estimated base budget of the tender","oneOf":[{"$ref":"#/components/schemas/TenderBudgetResponse"},{"type":"null"}]},"originalBudget":{"description":"Original budget of the tender as published by the source","oneOf":[{"$ref":"#/components/schemas/TenderBudgetResponse"},{"type":"null"}]},"buyers":{"type":"array","description":"Names of the buyer organizations","items":{"type":"string"}},"language":{"type":["string","null"],"description":"Language of the tender documentation","example":"eng"},"contractTypes":{"type":"array","description":"Contract types of the tender","items":{"type":"string"}},"enriched":{"type":"boolean"}}},"Award":{"type":"object","description":"Information about a contract award","properties":{"budgetCurrency":{"type":["string","null"],"description":"Currency of the awarded amount","example":"USD"},"budgetValue":{"type":["string","null"],"description":"Numerical value of the awarded amount as a string","example":"450000.0"},"description":{"type":["string","null"],"description":"Description of the awarded contract"},"publicationDate":{"type":["string","null"],"description":"Date when the award was published","example":"2024-01-15"},"organizations":{"type":"array","description":"List of organizations that received the award","items":{"$ref":"#/components/schemas/AwardOrganization"}}}},"AwardOrganization":{"type":"object","description":"Information about an organization that received an award","properties":{"name":{"type":["string","null"],"description":"Name of the winning organization"},"country":{"description":"Country of the winning organization","oneOf":[{"$ref":"#/components/schemas/Country"},{"type":"null"}]},"address":{"type":["string","null"],"description":"Physical address"},"phone":{"type":["string","null"],"description":"Phone number"},"fax":{"type":["string","null"],"description":"Fax number"},"email":{"type":["string","null"],"description":"Email address"},"website":{"type":["string","null"],"description":"Official website URL"},"postalCode":{"type":["string","null"],"description":"Postal or zip code"},"regType":{"type":["string","null"],"description":"Registration type (e.g., VAT, Company Number)"},"regNumber":{"type":["string","null"],"description":"Official registration number"},"businessType":{"type":["string","null"],"description":"Type of business entity","example":"Limited Liability Company"},"directorName":{"type":["string","null"],"description":"Name of the organization's director"},"tradeNames":{"type":["string","null"],"description":"Trading names used by the organization"},"details":{"type":["string","null"],"description":"Additional details about the organization"},"contactPersons":{"type":"array","description":"List of contact persons for the award","items":{"$ref":"#/components/schemas/ContactPerson"}}}},"ContactPerson":{"type":"object","description":"Contact person information within an organization","properties":{"contactName":{"type":["string","null"],"description":"Full name of the contact person","example":"John Doe"},"position":{"type":["string","null"],"description":"Job title or position","example":"Procurement Officer"},"email":{"type":["string","null"],"description":"Direct email address","example":"john.doe@example.com"},"address":{"type":["string","null"],"description":"Direct physical address if different from organization"},"phone":{"type":["string","null"],"description":"Direct phone number","example":"+1-212-555-0100"},"fax":{"type":["string","null"],"description":"Direct fax number","example":"+1-212-555-0101"},"postalCode":{"type":["string","null"],"description":"Postal or zip code","example":"10001"},"country":{"description":"Country of the contact person","oneOf":[{"$ref":"#/components/schemas/Country"},{"type":"null"}]}}},"Document":{"type":"object","description":"Information about a tender document","properties":{"id":{"type":["string","null"],"description":"Unique identifier of the document","example":"987654"},"name":{"type":["string","null"],"description":"Filename or display name of the document","example":"specs.pdf"},"type":{"type":["string","null"],"description":"Type of access: Stored or External","example":"Stored"},"link":{"type":["string","null"],"description":"Direct link to external document, available only if type is External"}}},"ExternalTender":{"type":"object","description":"Detailed information about a tender","properties":{"id":{"type":"string","description":"Unique identifier of the tender","example":"2309146"},"url":{"type":"string","description":"Direct URL to the tender in the Tenderwell portal","example":"https://tenderwell.com/tender/2309146"},"title":{"type":"string","description":"Title of the tender","example":"Vehicle Charging Infrastructure Solutions DPS"},"sectors":{"type":"array","description":"List of CPV (Common Procurement Vocabulary) sectors associated with the tender","items":{"$ref":"#/components/schemas/Sector"}},"deadlineDate":{"type":["string","null"],"description":"The deadline date for submission in ISO 8601 format","example":"2023-12-31T23:59:59Z"},"contractDuration":{"type":["string","null"],"description":"Duration of the contract or it's start and end periods","example":"24 months"},"status":{"type":["string","null"],"description":"Current status of the tender (e.g., OPEN, CLOSED)","example":"OPEN"},"placeOfOrigin":{"description":"Country of origin of the tender","oneOf":[{"$ref":"#/components/schemas/Country"},{"type":"null"}]},"placeOfPerformance":{"type":"array","description":"Countries where the contract will be performed","items":{"$ref":"#/components/schemas/Country"}},"description":{"type":["string","null"],"description":"Detailed description of the tender"},"descriptionEnriched":{"type":["string","null"],"description":"Enhanced or processed description"},"lastUpdateDate":{"type":["string","null"],"description":"Date and time of the last update in YYYY-MM-DD HH:mm:ss format","example":"2023-10-27 14:30:00"},"budgetCurrency":{"type":["string","null"],"deprecated":true,"description":"Currency of the estimated budget","example":"EUR"},"budgetValue":{"type":["string","null"],"deprecated":true,"description":"Numerical value of the estimated budget","example":"500000.0"},"baseBudget":{"description":"Estimated base budget of the tender","oneOf":[{"$ref":"#/components/schemas/TenderBudgetResponse"},{"type":"null"}]},"originalBudget":{"description":"Original budget of the tender as published by the source","oneOf":[{"$ref":"#/components/schemas/TenderBudgetResponse"},{"type":"null"}]},"sourceUrl":{"type":["string","null"],"description":"Original URL where the tender was published","example":"https://example.com/original-tender-link"},"source":{"description":"Information about the publication source","oneOf":[{"$ref":"#/components/schemas/Source"},{"type":"null"}]},"documents":{"type":"array","description":"List of associated tender documents","items":{"$ref":"#/components/schemas/Document"}},"buyers":{"type":"array","description":"List of buyer organizations","items":{"$ref":"#/components/schemas/Organization"}},"contractingAuthorities":{"type":"array","description":"List of contracting authorities","items":{"$ref":"#/components/schemas/Organization"}},"awards":{"type":"array","description":"List of contract awards if the tender is closed/awarded","items":{"$ref":"#/components/schemas/Award"}},"language":{"type":["string","null"],"description":"Language of the tender documentation","example":"en"},"contractTypes":{"type":"array","description":"Types of contract (e.g., SERVICES, WORKS, GOODS)","example":["SERVICES"],"items":{"type":"string"}},"createdDate":{"type":["string","null"],"description":"Date when the tender record was created in Tenderwell portal","example":"2023-10-20 09:00:00"},"publicationDate":{"type":["string","null"],"description":"Date when the tender was originally published","example":"2023-10-20"},"documentRetrievalGuidance":{"type":["string","null"],"description":"Guidance on how to retrieve or access official documents"}}},"Organization":{"type":"object","description":"Organization information (buyer, contractor, etc.)","properties":{"name":{"type":["string","null"],"description":"Name of the organization","example":"Department of Health"},"address":{"type":["string","null"],"description":"Full physical address","example":"123 Main St, New York, NY"},"email":{"type":["string","null"],"description":"General contact email","example":"info@example.com"},"phone":{"type":["string","null"],"description":"General phone number","example":"+1-212-555-0199"},"fax":{"type":["string","null"],"description":"General fax number","example":"+1-212-555-0198"},"contactPersons":{"type":"array","description":"List of specific contact persons within the organization","items":{"$ref":"#/components/schemas/ContactPerson"}},"website":{"type":["string","null"],"description":"Official website URL","example":"https://example.com"},"country":{"description":"Country where the organization is located","oneOf":[{"$ref":"#/components/schemas/Country"},{"type":"null"}]},"postalCode":{"type":["string","null"],"description":"Postal or zip code","example":"10001"}}},"Source":{"type":"object","description":"Tender source information","properties":{"name":{"type":["string","null"],"description":"Source name","example":"TED (Tenders Electronic Daily)"},"code":{"type":["string","null"],"description":"Internal source code","example":"ted_eu"},"url":{"type":["string","null"],"description":"Home URL of the source","example":"https://example.com"}}},"SortFieldsResponse":{"type":"object","properties":{"name":{"type":["string","null"]},"prettyName":{"type":["string","null"]}}},"StatusResponse":{"type":"object","properties":{"name":{"type":["string","null"]}}},"SectorDto":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"}}},"FullSectorDto":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/FullSectorDto"}}}},"RegionDto":{"type":"object","properties":{"name":{"type":"string"},"custom":{"type":"boolean"},"codeAlpha2":{"type":"string"},"countries":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}},"OrganizationTypeResponse":{"type":"object","properties":{"code":{"type":["string","null"]},"name":{"type":["string","null"]}}},"CurrencyResponse":{"type":"object","properties":{"name":{"type":["string","null"]}}},"ContractTypeDto":{"type":"object","properties":{"name":{"type":["string","null"]},"prettyName":{"type":["string","null"]}}}},"securitySchemes":{"X-API-KEY":{"type":"apiKey","name":"X-API-KEY","in":"header"}}}}