A JSON format to describe civic data resources & microservices

microcivic.json

{
	"name": "phl-property-tax-balances",
	"keywords": ["tax", "property", "delinquent", "deadbeat"],
	"license": "CC0",
	"sources": [{
		"name": "City of Philadelphia",
		"web": "http://opendataphilly.org",
		"email": "data@opendataphilly.org"
	}],
	"resources": [{
		"name": "Property tax balance API",
		"url": "https://data.phila.gov/resource/y5ti-svsu.json",
		"format": "json",
		"encoding": "UTF-8",
		"authentication": false,
		"ratelimit": true,
		"documentation": "https://www.opendataphilly.org/dataset/property-tax-balances/resource/927260a9-1e73-41c7-8553-9061d0334f47"
	}, {
		"name": "Property tax balance download",
		"path": "/realestate-tax-balance.csv",
		"format": "csv",
		"bytes": "",
		"hash": "sha1:8843d7f92416211de9ebb963ff4ce28125932878"
	}],
	"schema": {
		"fields": [{
				"name": "interest",
				"type": "number"
			},

			{
				"name": "lien_number",
				"type": "string"
			},

			{
				"name": "location",
				"type": "string"
			},

			{
				"name": "other",
				"type": "number"
			},

			{
				"name": "owner",
				"type": "string"
			},

			{
				"name": "parcel_number",
				"type": "string"
			},

			{
				"name": "penalty",
				"type": "number"
			},

			{
				"name": "principal",
				"type": "number"
			},

			{
				"name": "tax_period",
				"type": "number"
			},

			{
				"name": "total",
				"type": "number"
			}
		]
	}
}

Not sure exactly how to represent, but other things of interest would be:

• maturity: Some measure indicating adherence to quality standards
• validation: pointer to testing/validation resources
• use: pointer to or even just included usage resources (e.g., wrappers to get, display, test, etc.)