Getting Started

OCDS is an open data standard for publication of structured information on all stages of a contracting process: from planning to implementation.

The publication of OCDS data can enable greater transparency in public contracting, and can support accessible and in-depth analysis of the efficiency, effectiveness, fairness, and integrity of public contracting systems.

OCDS was designed with a focus on public procurement of goods, works and services, but can be extended for use in other contexts. Extensions for Public Private Partnership (PPP) and Extractives concessions are under development.

To get started publishing OCDS data:

When you are done you could be producing data that looks something like the contract release below, which is compatible with a growing range of OCDS aware tools (you will encounter a range of different OCDS release types in the following pages).

[
    {
        "language": "en",
        "ocid": "ocds-213czf-000-00001",
        "id": "ocds-213czf-000-00001-05-contract",
        "date": "2010-05-10T10:30:00Z",
        "tag": [
            "contract"
        ],
        "initiationType": "tender",
        "buyer": {
            "identifier": {
                "scheme": "GB-LAC",
                "id": "E09000003",
                "legalName": "London Borough of Barnet",
                "uri": "http://www.barnet.gov.uk/"
            },
            "name": "London Borough of Barnet",
            "address": {
                "streetAddress": "4, North London Business Park, Oakleigh Rd S",
                "locality": "London",
                "region": "London",
                "postalCode": "N11 1NP",
                "countryName": "United Kingdom"
            },
            "contactPoint": {
                "name": "Procurement Team",
                "email": "procurement-team@example.com",
                "telephone": "01234 345 346",
                "faxNumber": "01234 345 345",
                "url": "http://example.com/contact/"
            }
        },
        "awards": [
            {
                "id": "ocds-213czf-000-00001-award-01",
                "title": "Award of contract to build new cycle lanes in the centre of town.",
                "description": "AnyCorp Ltd has been awarded the contract to build new cycle lanes in the centre of town.",
                "status": "active",
                "date": "2010-05-10T10:30:00Z",
                "value": {
                    "amount": 11000000,
                    "currency": "GBP"
                },
                "suppliers": [
                    {
                        "identifier": {
                            "scheme": "GB-COH",
                            "id": "1234567844",
                            "legalName": "AnyCorp Ltd",
                            "uri": "http://www.anycorp.example"
                        },
                        "additionalIdentifiers": [
                            {
                                "scheme": "GB-VAT",
                                "id": "987654321"
                            }
                        ],
                        "name": "AnyCorp Cycle Provision",
                        "address": {
                            "streetAddress": "100 Anytown Lane",
                            "locality": "Anytown",
                            "region": "AnyCounty",
                            "postalCode": "AN1 1TN",
                            "countryName": "United Kingdom"
                        },
                        "contactPoint": {
                            "name": "Contracts Team",
                            "email": "contracts@anycorp.example",
                            "telephone": "12345 456 343",
                            "faxNumber": "12345 456 343"
                        }
                    }
                ],
                "items": [
                    {
                        "id": "0001",
                        "description": "string",
                        "classification": {
                            "scheme": "CPV",
                            "id": "45233130",
                            "description": "Construction work for highways",
                            "uri": "http://cpv.data.ac.uk/code-45233130"
                        },
                        "additionalClassifications": [
                            {
                                "scheme": "CPV",
                                "id": "45233162-2",
                                "description": "Cycle path construction work",
                                "uri": "http://cpv.data.ac.uk/code-45233162.html"
                            }
                        ],
                        "quantity": 8,
                        "unit": {
                            "name": "Miles",
                            "value": {
                                "amount": 137000,
                                "currency": "GBP"
                            }
                        }
                    }
                ],
                "contractPeriod": {
                    "startDate": "2010-07-01T00:00:00Z",
                    "endDate": "2011-08-01T23:59:00Z"
                },
                "documents": [
                    {
                        "id": "0007",
                        "documentType": "notice",
                        "title": "Award notice",
                        "description": "Award of contract to build new cycle lanes in the centre of town to AnyCorp Ltd.",
                        "url": "http://example.com/tender-notices/ocds-213czf-000-00001-04.html",
                        "datePublished": "2010-05-10T10:30:00Z",
                        "format": "text/html",
                        "language": "en"
                    }
                ]
            }
        ],
        "contracts": [
            {
                "id": "ocds-213czf-000-00001-contract-01",
                "awardID": "ocds-213czf-000-00001-award-01",
                "title": "Contract to build new cycle lanes in the centre of town.",
                "description": "A contract has been signed between the Council and AnyCorp Ltd for construction of new cycle lanes in the centre of town.",
                "status": "active",
                "period": {
                    "startDate": "2010-07-01T00:00:00Z",
                    "endDate": "2011-08-01T23:59:00Z"
                },
                "value": {
                    "amount": 11000000,
                    "currency": "GBP"
                },
                "items": [
                    {
                        "id": "0001",
                        "description": "string",
                        "classification": {
                            "scheme": "CPV",
                            "id": "45233130",
                            "description": "Construction work for highways",
                            "uri": "http://cpv.data.ac.uk/code-45233130"
                        },
                        "additionalClassifications": [
                            {
                                "scheme": "CPV",
                                "id": "45233162-2",
                                "description": "Cycle path construction work",
                                "uri": "http://cpv.data.ac.uk/code-45233162.html"
                            }
                        ],
                        "quantity": 8,
                        "unit": {
                            "name": "Miles",
                            "value": {
                                "amount": 137000,
                                "currency": "GBP"
                            }
                        }
                    }
                ],
                "dateSigned": "2015-06-10T14:23:12Z",
                "documents": [
                    {
                        "id": "0008",
                        "documentType": "contractSigned",
                        "title": "Signed Contract",
                        "description": "The Signed Contract for Cycle Path Construction",
                        "url": "http://example.com/contracts/ocds-213czf-000-00001",
                        "datePublished": "2015-06-10T16:43:12Z",
                        "format": "application/pdf",
                        "language": "en"
                    }
                ]
            }
        ]
    }
]