Contracts

get/{dataset}/v3/contracts

Dataset description:

Dataset focuses on publicly available contracts between private companies and publicly owned companies or public authorities. Publication of the contract in a open portal is legally required. Scope of contracts available is defined by the local legislation.

Availability:

Dataset updates:

Dataset is updated weekly

Selected use cases:

find contracts of your competitors and their validity range
make a market sizing of how much is spent by public authorities in a given area
see which companies are heavily dependent on public finances

Endpoint variables description:

Item commercial name	Path	Item description	Example	Always populated
Contract unique ID	data/ uniqueId	ID unique across countries	cz-contract-regsmluv-0019898135	Yes
Contract source URL	data/ url		https://smlouvy.gov.cz/smlouva/19898135	Yes
Contract version	data/ version		1	No
Contract title	data/ title		Dodatek č. 4 ke smlouvě na stravenky - zvýšení nominální hodnoty. ID SMLOUVY: 2291658	Yes
Contract summary	data/ summary		Tato smlouva stanovuje podmínky partnerství mezi Krajem Vysočina a ...	No
Contract content	data/ content		Smlouva o partnerstvi k projektu Potravinova pomoc dětem v Kraji Vysočina.	No
Contract validity state	data/ state		valid	Yes
Contract publishing date	data/ publishedAt		2022-04-04T17:00:21+00:00	Yes
Contract signature date	data/ signature/ createdAt		2022-04-04T00:00:00+00:00	Yes
Original language of the contract	data/ originalLanguage		cs	No
Contract value currency	data/ value/ currency		CZK	Inherited
Contract value amount	data/ value/ amount		63530	Inherited
Contract VAT amount	data/ value/ vat		0	Inherited
Contract value currency	data/ values/ currency		CZK	Inherited
Contract value amount	data/ values/ amount		63530	Inherited
Contract VAT amount	data/ values/ vat		0	Inherited
Contract value type	data/ values/ type		vatIncluded	No
Contract validity start date	data/ validFrom		2022-04-04T17:00:21+00:00	Yes
Contract validity end date	data/ validTo		null	No
Contract buyer party entity unique ID	data/ buyers/ uniqueId		cz-company-67985904	Inherited
Contract buyer party national ID	data/ buyers/ nationalIn		67985904	Inherited
Contract buyer party entity name	data/ buyers/ name		Ústav živočišné fyziologie a genetiky AV ČR, v. v. i.	No
Contract supplier party entity unique ID	data/ suppliers/ uniqueId		cz-company-24745391	Inherited
Contract supplier party national ID	data/ suppliers/ nationalIn		24745391	Inherited
Contract supplier party entity name	data/ suppliers/ name		Edenred CZ s.r.o.	No
Contract party entity national ID	data/ parties/ nationalIn		67985904	Inherited
Contract party entity unique ID	data/ parties/ uniqueId		cz-company-67985904	Inherited
Contract party entity type	data/ parties/ type		Company	Inherited
Contract party publisher flag	data/ parties/ isPublisher	Is this the entity, which has published the contract	True	Inherited
Contract party recipient flag	data/ parties/ isRecipient	Is this entity recipient of the contracted product/service	False	Inherited
Contract party name	data/ parties/ name		Firma s.r.o.	No

SecurityApiKey

Request

path Parameters

dataset

required

string

query Parameters

Company.NationalIn	string or null National IN of Company for requested Contracts.
Company.Role	string (BizMachine.Prospector.Api.DataStructures.Dtos.Contracts.v3.RoleCode) Role of Company in requested Contracts as a BizMachine.Prospector.Api.DataStructures.Dtos.Contracts.v3.RoleCode. Enum: "Any" "Buyer" "Supplier"
Published.From	string or null <date-time> Search data by System.DateTimeOffset starting from this value.
Published.To	string or null <date-time> Search data by System.DateTimeOffset up to this value.
Updated.From	string or null <date-time> Search data by System.DateTimeOffset starting from this value.
Updated.To	string or null <date-time> Search data by System.DateTimeOffset up to this value.
Offset	integer <int32> Allows to specify offset from where to start streaming results. Default value: 0
Limit	integer <int32> Default: 200 Allows to specify limit of returned data.
SortBy	string or null Sorting order and field to sort by in format sorting-order Valid orders: desc, asc. Example: desc(createdAt)

Responses

200

Success

Response samples

{"paging": {"totalItems": 0,
"totalPages": 0,
"pageSize": 0,
"currentPage": 0,
"maxPageSize": 0
},
"data": [{"data": {"uniqueId": "cz-contract-regsmluv-0000001301",
"url": "http://example.com",
"version": "string",
"title": "string",
"summary": "string",
"content": {"text": "string"
},
"state": "New",
"publishedAt": "2019-08-24T14:15:22Z",
"signature": {"person": {"name": "string"
},
"createdAt": "2019-08-24T14:15:22Z"
},
"originalLanguage": "cs",
"value": {"currency": "CZK",
"amount": 376929,
"vat": 21
},
"values": [{"type": "vatIncluded",
"currency": "CZK",
"amount": 376929,
"vat": 21
}
],
"entities": [{"type": "string"
}
],
"validFrom": "2019-08-24T14:15:22Z",
"validTo": "2019-08-24T14:15:22Z",
"buyers": [{"uniqueId": "string",
"nationalIn": "string",
"name": "string"
}
],
"suppliers": [{"uniqueId": "string",
"nationalIn": "string",
"name": "string"
}
],
"parties": [{"type": "string",
"isPublisher": true,
"isRecipient": true,
"isPayer": true
}
],
"keywords": ["string"
],
"topics": [{"code": "string",
"name": "string",
"confidence": 0
}
],
"attachments": [{"url": "http://example.com",
"title": "string",
"hash": {"value": "378dbad7b9f4145cad5be6dacea466e58ea86a823e40f03d13d93c8c29106f4b",
"algorithm": "sha2"
},
"text": "string",
"publishedAt": "2019-08-24T14:15:22Z"
}
]
},
"meta": {"dataSources": [{"code": "string",
"name": "string",
"externalId": "string",
"url": "string"
}
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"prospector": {"link": "string"
},
"hash": "string"
}
}
]
}

➔ Next to Custom Data