Documentation
One published notice
GET/v1/notices/{id}
Open to any caller. A key is not required and does not change the answer.
Returns one published notice by its id, which never changes. Every notice of a procurement answers here, including those the listing shows under another notice; listedNotice names that one. To start from the slug in a notice's address on fentlig.se, use GET /v1/notices?slug=, which answers with this same body. No API key is needed; every published notice is also a page on fentlig.se, listed in https://fentlig.se/sitemap.xml.
curl "https://api.fentlig.se/v1/notices/<id>"Parameters
| Parameter | In | Type | Notes |
|---|---|---|---|
idrequired | path | string | uuid |
countryoptional | query | string | |
foreign_buyersoptional | query | enum | excludeinclude |
Response 200
The notice
| Field | Type | Notes |
|---|---|---|
data | object | |
data.id | string | uuid |
data.slug | string | |
data.title | string | |
data.buyerName | stringnullable | |
data.buyerId | stringnullable | uuid |
data.buyerUnit | objectnullable | |
data.buyerUnit.name | string | |
data.buyerUnit.kind | enumnullable | joint_centrenull |
data.buyerUnit.id | stringnullable | |
data.status | enum | plannedopenclosedconcluded |
data.publicationDate | string | date-time |
data.deadlineDate | stringnullable | date-time |
data.regionCodes | string[] | |
data.mainCpv | objectnullable | |
data.mainCpv.code | string | |
data.mainCpv.label | stringnullable | |
data.mainCpv.isMain | boolean | |
data.procedureCode | stringnullable | |
data.estimatedValue | numbernullable | |
data.currency | stringnullable | |
data.source | string | |
data.sourceUrl | stringnullable | |
data.description | stringnullable | |
data.cpvCodes | object[] | |
data.cpvCodes[].code | string | |
data.cpvCodes[].label | stringnullable | |
data.cpvCodes[].isMain | boolean | |
data.regions | object[] | |
data.regions[].code | string | |
data.regions[].name | stringnullable | |
data.noticeType | string | |
data.publicationNumber | stringnullable | |
data.frameworkMaxValue | numbernullable | |
data.awardOutcome | objectnullable | |
data.awardOutcome.awardDate | stringnullable | date-time |
data.awardOutcome.bidCount | integernullable | min 0 |
data.awardOutcome.awardedValue | numbernullable | |
data.awardOutcome.currency | stringnullable | |
data.awardOutcome.lotCount | integer | min 0 |
data.awardOutcome.lotsAwarded | integernullable | min 0 |
data.awardOutcome.lotsNotAwarded | integernullable | min 0 |
data.awardOutcome.lotsUndecided | integernullable | min 0 |
data.related | object[] | |
data.related[].id | string | uuid |
data.related[].slug | string | |
data.related[].title | string | |
data.related[].status | enum | plannedopenclosedconcluded |
data.related[].publicationDate | string | date-time |
data.depthWithheld | boolean | |
data.resultPublishedElsewhere | boolean | |
data.resultNoticeCount | integer | min 0 |
data.resultNotices | object[] | |
data.resultNotices[].id | string | uuid |
data.resultNotices[].slug | string | |
data.resultNotices[].title | string | |
data.resultNotices[].status | enum | plannedopenclosedconcluded |
data.resultNotices[].publicationDate | string | date-time |
data.listedNotice | objectnullable | |
data.listedNotice.id | string | uuid |
data.listedNotice.slug | string | |
data.listedNotice.status | enum | plannedopenclosedconcluded |
data.listedNotice.deadlineDate | stringnullable | date-time |
coverage | object | |
coverage.sources | string[] | |
coverage.attribution | object[] | |
coverage.attribution[].source | string | |
coverage.attribution[].text | string | |
coverage.dataAsOf | stringnullable | date-time |
coverage.isComplete | enum | false |
coverage.note | string |
Failures
- 400The path segment is not a notice id
- 401The API key sent is unknown, revoked or expired. Send a valid key, or none on an operation that needs none.
- 403The API key sent belongs to a workspace whose subscription has ended. The same request without a key answers.
- 404No published notice has this id in the markets the request covers
- 429Too many requests in the current window, from this key or, without a key, from this address. Wait the number of seconds in `Retry-After`, then send the request again.
Every one is an RFC 9457 problem document carrying a stable code. See the error reference.