beta This is a trial service – your feedback will help us to improve it.

Environment Agency open ePR (electronic Public Register) API

Introduction

The Environment Agency licenses industry, business and individuals to carry out certain activities that have the potential to pollute the environment. When we receive an application for such a licence, we make that application and other relevant information available to the public. We do this before we make the decision of whether to issue the licence, or what conditions we will attach to it.

After any permit is issued, further information is also made available on the registers. This can typically include monitoring information, details of any breaches of the terms of the licence, any enforcement actions that we have carried out and any applications to vary the terms of the licence.

The open ePR (electronic Public Register) provides access to this registration and permit information both in the form of searchable web pages and as data which can be accessed by developers via an API (Application Program Interface).

These APIs are provided under the Environment Agency Conditional Licence with no requirement for registration. If you make use of this data please note the conditions carefully.

For questions on the API, or to report problems, please send us an email.

Note on terminology

The different public registers use different terminology for the things that they contain. These include registration, permit, licence and enforcement action.

The API, and much of this documentation, uses the generic term registration, meaning anything that has been recorded in a register. This uniformity enables a single API to work across registers.

When a register contains a specific type of registration, for example an Environmental Permit, the data items will be marked as being of that type and the user interface will display the entries using the appropriate terminology.

The API provides and uses web addresses for all the entities involved - registers, individual registrations, holders and sites associated with registrations. We use the term URI for these web addresses.

API summary

This is a brief summary of the APIs available, see below for details. In the links in the tables {root} corresponds to http://environment.data.gov.uk/public-register.

Endpoints

WhatAPIComments
Search across registers {root}/api/search See below for available search parameters
List entries in a register {root}/{register}/registration Same search filters as above
Retrieve an entry {root}/{register}/registration/{id} The URI can be found using the above search options
Name/number lookup {root}/api/completion Text completion to find possible names of holders or registration numbers based on a partial text entry.

Register search filter parameters

These parameters enable the list of entries in a register to be filtered to find the ones of interest. The same filters are available for both cross-register search and for filtering the set of registrations within a single register.

WhatQueryComments
Return registrations with exactly this name name=x x must be the complete name of the holder of the registration exactly as recorded (including spacing and punctuation). This is not a text search (see below) but is useful when the name has been found using the name completion facility.
Return registrations with exactly this registration number registrationNumber=x x must be the complete registration number, exactly as recorded in the register. This is not a text search (see below) but is useful when the number has been found using the number completion facility.
Filter by name or registration number name-number-search=x Return those entries whose holder name or registration number matches x.
Filter by name name-search=x Return those entries whose holder name matches x.
Filter by registration number number-search=x Return those entries whose registration number matches x.
Filter by address address-search=x Return those entries whose site address includes elements that match x, for example town, street or postcode.
Filter by local authority local-authority=x Return those entries associated with local authority x. Only applicable to registers containing local authority information.
Return those entries whose site location is within some radius of a point. easting=x&northing=y&dist=d The distance d is in km from the given OS grid point. Only applicable to registers which contain information on geographic location of the site.
Filter to just entries within a given register register=r The value to use for r can be found from the next-to last segment of the URI for the register, for example scrap-metal-dealers.
Filter to just entries of a given regime or type regime=r The interpretation of this filter depends on the specific register, see below.

The filters depend on the register including the relevant information. For example, Scrap Metal Dealers registered as Collectors have no registered address so filtering on address or location is not effective for them.

Specific registers

Register Stub Name search Address search Location search Local Authority search Special filters
Waste Carriers, Brokers and Dealers waste-carriers-brokers regime
Waste Exemptions waste-exemptions
Scrap Metal Dealers scrap-metal-dealers Sites only
Enforcement Actions enforcement-action actionType offenceType agencyFunction after before
Water Quality Exemptions water-discharge-exemptions
Environmental Permitting Regulations – Radioactive Substances radioactive-substance
Environmental Permitting Regulations – Installations industrial-installations
Environmental Permitting Regulations – Waste Operations waste-operations
Environmental Permitting Regulations – Discharge Consents water-discharges

API structure

The APIs provide a REST style access to the data via simple HTTP GET requests which return data in JSON, CSV or RDF formats (as well as providing an HTML rendering for web browsers).

Simple requests

For example fetching data from:

will return a JSON data packet such as:

{ 
  "@context" : "http://environment.data.gov.uk/public-register/view/doc/context-TBD.jsonld" ,
  "meta" : { 
    "publisher" : "Environment Agency" ,
    "licence" : "https://www.gov.uk/government/publications/environment-agency-conditional-licence/environment-agency-conditional-licence" ,
    "documentation" : "http://environment.data.gov.uk/public-register/view/api-documentation.html" ,
    "version" : "0.2" ,
    "comment" : "Beta service" ,
    "hasFormat" : [ 
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.csv",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.rdf",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.ttl",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.html" 
    ]
  },
  "items" : [ { 
    "@id" : "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG" ,
    "area" : { ... } ,
    "effectiveDate" : "2014-05-01" ,
    "holder" : {
      "name" : "Magnox Limited", ...
    } ,
    "localAuthority" : { ... } ,
    "notation" : "GB3435DG" ,
    "register" : { 
      "@id" : "http://environment.data.gov.uk/public-register/radioactive-substance/register"
    } ,
    "registrationNumber" : "GB3435DG" ,
    "registrationType" : { 
      "label" : "Disposal of Radioactive Waste (N)" ,  ...
    }  ,
    "site" : { 
      "siteAddress" : {
        address: "Oldbury Power Station, Oldbury Naite, Thornbury, Bristol, BS35 1RQ", ...
      }, ...
    } 
  }, ... ]
}

The returned JSON data from all API endpoints follows the same structure of three elements: context, metadata and item(s).

The @context reference is provided to enable the JSON data to be read as json-ld, in the future.

Metadata and versioning

The metadata block:

"meta" : { 
    "publisher" : "Environment Agency" ,
    "licence" : "https://www.gov.uk/government/publications/environment-agency-conditional-licence/environment-agency-conditional-licence" ,
    "documentation" : "http://environment.data.gov.uk/public-register/view/api-documentation.html" ,
    "version" : "0.2" ,
    "comment" : "Beta service" ,
    "hasFormat" : [ 
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.csv",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.rdf",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.ttl",
      "http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.html" 
    ]
  }

provides information on the publisher and applicable licence as well as a link to this, or other, documentation. If the resource is also available in other formats then hasFormat will supply list of URLs for those alternative formats (the media type is implied a suffix, see content types).

The metadata block also includes version number information. The intention is that updates to the API should maintain backward compatibility. If an incompatible change to the API is required then we will attempt to provide access to the prior version for a transitional period. In that case the meta block will also provide replaces and isReplacedBy links between the new and the old versions of the affected API endpoints.

Finally, in the case of calls which provide lists of results then any applied limit to the length of the list and offset from the start of the list will be shown in the metadata as limit and offset values, for example:

"meta" : { 
    "publisher" : "Environment Agency" ,
    "licence" : "https://www.gov.uk/government/publications/environment-agency-conditional-licence/environment-agency-conditional-licence" ,
    "documentation" : "http://environment.data.gov.uk/public-register/view/api-reference" ,
    "version" : "0.2" ,
    "comment" : "Beta service" ,
    "limit" : 10,
    "offset" : 5
  }

Note that some endpoints may impose a length limit even if one has not be specified explicitly by the caller. In particular the register endpoints limit the default length to 2000 results. The metadata is particularly useful in this case as a warning that this has occurred.

Items

The items element in the JSON response will contain either a description of a single item or an array of items. For API endpoints which return lists of items (e.g. all registrations in a register) then the value will always be an array even if the list only has one entry. For API endpoints which describe a specific item (e.g. a registration) the value will always be an object, with no wrapping array.

Each item will normally be identified by a URI given in the @id field.

Content Types

The descriptions of individual items can be obtained in multiple formats. The default format is a human readable HTML render but all item descriptions can also return information in JSON and RDF formats (RDF/XML and Turtle).

Similarly lists of items can be obtained in multiple formats. The default is again human readable HTML but they also support JSON (in which case the items field will contain an array of objects), CSV and RDF formats.

To select the desired format use standard HTTP content negation. E.g.:

curl -i -H "Accept: text/turtle" http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG

All endpoints also support a short cut of appending a type suffix to the URI to force a particular content type. The supported suffixes are:

SuffixType
.jsonapplication/json
.htmltext/html
.csvtext/csv
.ttltext/turtle
.rdfapplication/rdf+xml

Lists: filtering and paging

Some endpoints return information describing a single identified item but many return information on a list of items. In that case the value of the items field is an array of items. Such list endpoints support query parameters to filter the list to only include some items, see below for details.

In addition to filtering then list endpoints support view modification parameters, these are distinguished by starting with an underscore character. The commonly supported modifiers are:

QueryMeaning
?_limit=xReturn only x items from the list, some endpoints may impose a default limit and/or a maximum to which the limit can be set.
?_offset=xReturn the list of items starting with the xth item, together with _limit this enables paging through a long set of reults.

If a limit or offset is applicable, whether explicit in the query or implicitly imposed by the API, then the metadata object will include a limit or offset field to show what limits were applied.

Register search - general

The cross register search endpoint:

http://environment.data.gov.uk/public-register/api/search

returns a list of registration/permit entries which match some search criteria. The criteria are supplied as query parameters and are summarized above and explained here. By default the search returns information as an HTML page but for programmatic use you can request it as JSON or as a CSV (see above).

The individual registers each have a root address which lists all of the registrations that they contain and support exactly the same search criteria. For example:

http://environment.data.gov.uk/public-register/waste-carriers-brokers/registration

Text filters

Each registration has a number of associated text fields (name of the holder of the registration, registered address, registration number) and the search queries can filter the list of registrations to only return those where a text field matches a text query. The text queries are treated as prefixes(so Atkin would match Atkins, Atkinson and so on). To search for a match somewhere within the field you can prefix the search with * (so *tkins would match Atkins, Watkins and so on). If the search string contains more than one word then each is matched separately (so jo atkin would match John Atkinson and Atkins Joinery).

Note that registration numbers will also be treated as collections of words so that a registration number such as CB/HE5831CE will be found by a search for HE5831 even though the initial CB/ is missing.

As a special case a word ending in a number will be treated as an exact word mach so A2 will match A2 or CB/A2/001 but not A27 or CB/A231/001. This is to avoid confusion when searching for numeric entries. If you need to search for a registration number by prefix then use an explicit wildcard charater e.g. A2*.

The text searches supported are shown below.

WhatQueryComments
Filter by name name-search=x Match the name of the holder of the registration or permit.
Filter by registration number number-search=x Match the registration number.
Filter by address address-search=x Searches any element of the address of the site associated with the registration. The search includes the street name, town and postcode.

If more than one query is included then all the queries must match.

A common requirement is to search for a specific registration knowing either the name of the registered person/business or the registration number. To enable this to be done using a single query we support the following search:

WhatQueryComments
Filter by name or registration number name-number-search=x

Location filters

In addition to search by text matching it is also possible to search or restrict a search by location. This is done by specifying a point as an Easting and Northing on the OS National Grid (OSGB36) plus a radius in km. This restricts the results to those entries whose location falls in that circle. The location is only approximate (e.g. it may be based on the centre of the associated postcode area) and should not be relied upon as a precise position.

WhatQueryComments
Entries whose location is within some radius of a point easting=x&northing=y&dist=d The distance d is in km from the given OS grid point.

NB This filtering will only work on those registers which include location information. Some registrations do not have an associated address at all, or have some form of address but no clear geographic location. In particular, see the notes on the register for Scrap Metal Dealers below.

Some registers associate a Local Authority with the registration. Examples include Scrap Metal Dealers (where the information is collected and owned by local authorities) and Radioactive Substances Permits. In those cases it is possible to search or restrict a search by Local Authority.

WhatQueryComments
Entries with the given Local Authority local-authority=x The Local Authority is identified by a standard name.

The local authorities are all identified by standardized URIs but for convenience the local-authority search filter uses the name of the authority. A list of all the Local Authorities mentioned in the registers, with their associated names, is available in html, json and csv.

Retrieve by name or registration number

In addition to the text and location search there are two query options which return only entries whose name or registration number exactly matches the query. The match has to be exact - same case, spacing and punctuation. These facilities are usually used in conjunction with text completion facilities (see below).

WhatQueryComments
Entry with exact match of registration number registrationNumber=x x must be the complete and exact number, this is not a text search
Entries with exactly this name name=x x must be the complete and exact name of the holder of the registration, this is not a text search

Returned data

For cross-register searches the matches are returned as a list of short form registration descriptions containing the following fields:

FieldMeaningTypeOccursViews
distanceOnly present when searching by location and indicates the distance from that location in km.optionaldefault
expiryDateThe current date at which the registration will expire unless it is renewed.xsd:dateoptionaldefault
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.nameThe full name of the person or organizationdefault
holder.typeThe class or type of this holder.xsd:stringoptionaldefault
localAuthorityThe Local Authority associated with this registration, if any.optionaldefault
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationDateThe date of registration associated with a register items such as a Permit or Registrationxsd:dateoptionaldefault
registrationNumberThe permission, permit or registration numberdefault
registrationTypeThe type of registration with the register.optionaldefault
registrationType.labelA name for the registrationType.rdf:langStringdefault
siteThe site associated with the registration, may have an address and a geographic location.org:Siteoptionaldefault
site.siteAddressThe address of the sitedefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressdefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsdefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault
site.siteAddress.telTelephone number as a tel: URIoptionaldefault
tierThe tier within a multi-tier register (for example upper/lower tier Waste Carriers Brokers and Dealers).reg:Tieroptionaldefault
tier.labelA name for the tier.rdf:langStringdefault
typeThe class or type of this Item.xsd:stringdefault

Searches over specific registers generally return similar results but some registers have specific extra information or significant differences in structure. See later sections for register-specific details.

Registration retrieval

Given the URI for an individual registration, typically found by the above register search facilities, then a full description of that entry can be retrieved by just fetching that URI. By default this returns a readable description in HTML but for programmatic use can return JSON or RDF (Turtle or RDF/XML) formats (see above).

For example to get a JSON description of registration GB3435DG from the regisiter of Radioactive Substances Permits use:

http://environment.data.gov.uk/public-register/radioactive-substance/registration/GB3435DG.json

This will return data in a similar format to the search results.

Text completion

In addition to the search and retrieval facilities then some simple APIs are provided to assist with UI construction. These take a partial word fragment and return a list of names or registration numbers that contain the fragment. Since these are not retrieval APIs, and not part of the default presentation, they do not support the full range of content negotiation and metadata. They simply return a JSON array of strings containing the available completions.

In the links in the table {root} corresponds to http://environment.data.gov.uk/public-register.

WhatAPI
Names of registration holders containing the given string {root}/api/completion?name={x}&infix
Names of registration holders containing words starting with the given string {root}/api/completion?name={x}
Registration numbers containing the given string {root}/api/completion?number={x}&infix

So, for example, a search such as:

{root}/api/completion?name=flower

Returns a simple list:

[
  "APPLETON & FLOWERS LTD",
  "FRANCIS FLOWER (NORTHERN) LIMITED",
  ...
]

These names (or registration numbers) can then be used with the name (or number) exact match filters to locate the corresponding registrations.

Specific registers

Waste Carriers, Brokers and Dealers

Base URI:

http://environment.data.gov.uk/public-register/waste-carriers-brokers/registration

The register of Waste Carriers, Brokers and Dealers is complicated by the existence of two tiers of registration - Upper Tier and Lower Tier. Within the open ePR API we treat these as a single multi-tiered register. Within the Upper Tier then businesses or individuals can be registered as Waste Carriers and Dealers, Waste Brokers and Dealers or Waste Carriers, Brokers and Dealers. Within the Lower Tier there is no such distinction made and all registrations cover any of waste brokers, carriers and dealers.

Within the data we represent this by using the registrationType property to convey what the holder is registered as and the tier property to convey which of the two tiers they are registered within.

For convenience in the API we provide a single query parameter regime which can be used to select which registrations to return. It take the follow values:

QueryMeaning
regime=carrier-broker-dealer Upper Tier registrations as Waste Carrier, Broker and Dealer.
regime=carrier-dealer Upper Tier registrations as Waste Carrier and Dealer.
regime=broker-dealer Upper Tier registrations as Waste Broker and Dealer.
regime=upper-tier Any Upper Tier registration.
regime=lower-tier Any Lower Tier registration.

The register of Waste Carriers, Brokers and Dealers supports search by address and location, but not by Local Authority.

Waste exemptions

Base URI:

http://environment.data.gov.uk/public-register/waste-exemptions/registration

A waste exemption is a waste operation that is exempt from needing an environmental permit. Each exemption has specific limits and conditions that the holder must operate within.

The address of the holder (holder.hasAddress) is often different from the site to which the registration applies (site.siteAddress). A registration may include more than one site. A site may be associated with more than one exemption. Each exemption has an associated registrationType identifying the exemption and asscocated registrationDate and expiryDate.

Summary of data returned for a Waste Exemption registration

FieldMeaningTypeOccursViews
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.hasAddressThe organization address for the holder of the registration.default
holder.hasAddress.addressThe full address text including postcodedefault
holder.hasAddress.distanceOnly present when searching by location and indicates the distance from that location in km.optionaldefault
holder.hasAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
holder.hasAddress.organization_nameThe organization name to use in the addressoptionaldefault
holder.hasAddress.postcodePostcode for the addressoptionaldefault
holder.hasAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
holder.hasAddress.premisesName for the premisesoptionaldefault
holder.hasAddress.street_addressThe number and street name part of the addressoptionaldefault
holder.hasAddress.typeThe class or type of this holder.hasAddress.xsd:stringdefault
holder.nameThe full name of the person or organizationdefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationNumberThe permission, permit or registration numberdefault
siteA property for associating some thing, usually a Registration or a Permit, with a site.org:Sitemulti-valueddefault
site.exemptionExemption regsitered for the sitemulti-valueddefault
site.exemption.expiryDateThe current date at which the registration will expire unless it is renewed.xsd:dateoptionaldefault
site.exemption.registrationDateThe date of registration associated with a register items such as a Permit or Registrationxsd:dateoptionaldefault
site.exemption.registrationTypeThe type of the exemption registereddefault
site.exemption.registrationType.codeCategoryGroup of the exemption typedefault
site.exemption.registrationType.descriptionA textual description of the site.exemption.registrationType.xsd:stringdefault
site.exemption.registrationType.notationA string or other literal which uniquely identifies the site.exemption.registrationType.default
site.exemption.registrationType.prefLabelPreferred label for the exemption typedefault
site.exemption.registrationType.seeAlsoLink to descriptive web page for this exemption typedefault
site.locationGeographic location for the siteoptionaldefault
site.location.gridReferenceBritish National Grid Reference for the siteoptionaldefault
site.siteAddressThe address of the site of the exemptiondefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.premisesName for the premisesoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault

Scrap Metal Dealers

Base URI:

http://environment.data.gov.uk/public-register/scrap-metal-dealers/registration

The register of Scrap Metal Dealers supports two forms of permit - Site and Collector. For the open epR API we use the registrationType property to indicate the type of permit.

Collectors are mobile operators and their registration does not include an address. Sites do have an address but, in the current release, no geographic location. So the register does not support search by geographic location. It does support text search over the text of the address, but such a search will only return permits of type Site.

Scrap Metal Dealer information comes directly from Local Authorities so each permit has an associated Local Authority field and search by Local Authority is supported.

A single permit may apply to multiple sites. In that case the site property for the registration will be an array containing information on each site. The user interface, and the CSV downloads, split these into separate lines for convenience.

Enforcement Actions

Base URI:

http://environment.data.gov.uk/public-register/enforcement-action/registration

Enforcement actions are quite distinct in structure to the other registers. The structure of the return from a listing of this register is as follows:

FieldMeaningTypeOccursViews
actionDateThe date of the action.xsd:datedefault
notationA string or other literal which uniquely identifies the action.default
offenceStructure describing one or more offences which are the subject of the action.reg:Offenceoptionaldefault
offence.actionTypeURI that identifies the type of action taken.default
offence.actionType.prefLabelName for type of action (Caution, Court Case, Enforcement Notice)default
offence.agencyFunctionURI indicating a function within the Environment Agency associated with some actionreg:AgencyFunctiondefault
offence.agencyFunction.prefLabelA label for the Environment Agency function.default
offence.legislationTitleThe title or an common abbreviation of the title of a legislation (primary or secondary) associated a register item (typically the title of legislation that defines the offence against which an enforcement action is being taken).rdf:langStringdefault
offenderThe person or business subject to the action.foaf:Agentdefault
offender.hasAddressStructure giving the address of the offender.optionaldefault
offender.hasAddress.addressTextual summary of postal address.default
offender.nameName of the person or business associated with the action.default
registerThe Register associated with some registered itemreg:Registerdefault

The description of an individual entry in the register is rather richer. The most relevant additional fields are:

FieldMeaningTypeOccurs
registrationNumber String (numeric) which identifies the enforcement action.
incident Structure giving reference numbers that identify the incident associated with the enforcement action. reg:Incident optional
offence.description Textual description of the offence.
offence.legislationTitle Title (or common abbreviation) of the legislation that defines the offence against which the enforcement action is being taken.
offence.legislationSection Identifies the section of the legislation that defines the offence.
offence.impactAir Concept defining the level of impact of the offence as related to Air. skos:Concept
offence.impactAir.label Text describing the level of impact of the offence as related to Air (none, minor, significant, major).
offence.impactLand Concept defining the level of impact of the offence as related to Land. skos:Concept
offence.impactLand.label Text describing the level of impact of the offence as related to Land (none, minor, significant, major).
offence.impactWater Concept defining the level of impact of the offence as related to Water. skos:Concept
offence.impactWater.label Text describing the level of impact of the offence as related to Water (none, minor, significant, major).
offender.industrySector Concept defining the industry sector which the offender is associated with. skos:Concept
offender.industrySector.prefLabel Preferred textual label for the industry sector.

Water Quality Exemptions

Base URI:

http://environment.data.gov.uk/public-register/water-discharge-exemptions/registration

The structure of Water Quality Exemptions is similar to standard register entries except there is no holder associated with the exemption, just a site. This means the exemptions can be found by location and address search, or by search on exemption (registration) number but not by holder name.

The structure of data returned for this register is as follows:

FieldMeaningTypeOccursViews
localAuthorityLocal Authority corresponding the site of the exemption.default
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
notationUnique identifier for registrationdefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationNumberThe permission, permit or registration numberdefault
siteThe site of the exemptionorg:Sitedefault
site.exemptionThe exemption at this site.reg:Exemptiondefault
site.exemption.registrationTypeThe type of the exemption.reg:RegistrationTypedefault
site.exemption.registrationType.commentAn explanatory comment or description of the site.exemption.registrationType.xsd:stringdefault
site.exemption.startDateStart date for the exemptionxsd:date
site.locationGeographic location of the siteoptionaldefault
site.location.eastingThe easting of the point on the British National Gridxsd:decimaldefault
site.location.gridReferenceBritish National Grid Reference for the locationoptionaldefault
site.location.northingThe easting of the point on the British National Gridxsd:decimaldefault
site.siteAddressThe address of a site for the organizationdefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault

Radioactive Substances permits

Base URI:

http://environment.data.gov.uk/public-register/radioactive-substance/registration

The register of Environmental Permits for Radioactive Substances contains permits relating to specific activities within the relevant legislation. In the open ePR API we use the registrationType property to indicate type of the permit.

The structure of data returned for this register is as follows:

FieldMeaningTypeOccursViews
effectiveDateThe date from which a Permit or Registration is in effect.xsd:datedefault
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.nameThe full name of the person or organizationdefault
localAuthorityLocal Authority corresponding the permit.default
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationNumberThe permission, permit or registration numberdefault
registrationTypeA property that expresses as more detailed register specific classification or type for a registration, permit, exemption or enforcement-action (a register item)reg:RegistrationTypedefault
registrationType.labelA name for the registrationType.rdf:langStringdefault
siteThe site of the permitorg:Sitedefault
site.locationGeographic location of the siteoptionaldefault
site.location.eastingThe easting of the point on the British National Gridxsd:decimaldefault
site.location.northingThe easting of the point on the British National Gridxsd:decimaldefault
site.siteAddressThe address of a site for the organizationdefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault

Environmental Permitting Regulations - Installations

Base URI:

http://environment.data.gov.uk/public-register/industrial-installations/registration

The structure of data returned for this register is as follows:

FieldMeaningTypeOccursViews
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.nameThe full name of the person or organizationdefault
localAuthorityLocal Authority corresponding the permit.default
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
notationUnique identifier for registration, combining code for Local Authority with registration numberdefault
regimeFull URI of the register or regime under which this record is registeredreg:Regimedefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationDateThe date of registration associated with a register items such as a Permit or Registrationxsd:datedefault
registrationNumberThe permission, permit or registration numberdefault
siteThe site of the permitorg:Sitedefault
site.locationGeographic location of the siteoptionaldefault
site.location.eastingThe easting of the point on the British National Gridxsd:decimaldefault
site.location.gridReferenceBritish National Grid Reference for the locationoptionaldefault
site.location.northingThe easting of the point on the British National Gridxsd:decimaldefault
site.siteAddressThe address of a site for the organizationdefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault
typeThe class or type of this Item.xsd:stringdefault

Environmental Permitting Regulations - Waste Operations

Base URI:

http://environment.data.gov.uk/public-register/waste-operations/registration

The Waste Operations registrations are more complex that for most registers in that they include a number of different life cycle dates (transfer, modification, revocation etc) and have multiple associated registration numbers. In addition to the registration number in the ePR these entries also have a Waste Management Licence number and search by number will match either of these fields.

The structure of data returned for this register is as follows:

FieldMeaningTypeOccursViews
effectiveDateThe date from which a Permit or Regisitration is in effect.xsd:dateoptionaldefault
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.nameThe full name of the person or organizationdefault
holder.tradingNameTrading name of the licence holderoptionaldefault
issuedDateThe date on which the permit was issued.xsd:dateoptionaldefault
localAuthorityLocal Authority corresponding the permit.default
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
modificationDateThe date on which a Permit or Registration was modified or amended.xsd:dateoptionaldefault
notationUnique identifier for registrationdefault
otherLicenceNumberOther licence number - pre-EA permit refoptionaldefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationNumberThe permission, permit or registration numberdefault
revocationDateThe date on which a Permit or Registration was revoked.xsd:dateoptionaldefault
siteThe site of the permitorg:Sitedefault
site.locationGeographic location of the siteoptionaldefault
site.location.eastingThe easting of the point on the British National Gridxsd:decimaldefault
site.location.gridReferenceBritish National Grid Reference for the locationoptionaldefault
site.location.northingThe easting of the point on the British National Gridxsd:decimaldefault
site.premisesName of the premisesoptionaldefault
site.siteAddressThe address of a site for the organizationdefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault
site.siteTypeType of sitedefault
site.siteType.notationA string or other literal which uniquely identifies the site.siteType.default
statusStatus of this registrationreg:Statusdefault
status.commentAn explanatory comment or description of the status.xsd:stringdefault
surrenderDateThe date on which a Permit or Registration was surrendered.xsd:dateoptionaldefault
suspensionDateThe date on which a Permit or Registration was suspended.xsd:dateoptionaldefault
transferDateThe date on which a Permit or Registration was transferred to a different holder.xsd:dateoptionaldefault
wasteManagementLicenceNumberWaste managment licence numberoptionaldefault

Environmental Permitting Regulations - Discharge Consents

Base URI:

http://environment.data.gov.uk/public-register/water-discharges/registration

The structure of data returned for this register is as follows:

FieldMeaningTypeOccursViews
effectiveDateThe date from which a Permit or Regisitration is in effect.xsd:datedefault
effluentTypeThe type of effluent.default
effluentType.commentDescription of the effluentTypexsd:stringdefault
holderThe agent (person or organization) which holds the registration or permit.foaf:Agentdefault
holder.nameThe full name of the person or organizationdefault
localAuthorityLocal Authority corresponding the permit.default
localAuthority.labelA name for the localAuthority.rdf:langStringdefault
notationUnique identifier for registration, combining code for Local Authority with registration numberdefault
registerThe Register associated with some registered itemreg:Registerdefault
register.labelA name for the register.rdf:langStringdefault
registrationNumberThe permission, permit or registration numberdefault
revocationDateThe date on which a Permit or Registration was revoked.xsd:dateoptionaldefault
siteThe site of the permitorg:Sitedefault
site.locationGeographic location of the siteoptionaldefault
site.location.eastingThe easting of the point on the British National Gridxsd:decimaldefault
site.location.gridReferenceBritish National Grid Reference for the locationoptionaldefault
site.location.northingThe easting of the point on the British National Gridxsd:decimaldefault
site.premisesName of the premisesoptionaldefault
site.siteAddressThe address of a site for the organizationdefault
site.siteAddress.addressThe full address text including postcodedefault
site.siteAddress.localityThe locality part of the address, includes town and region or countyoptionaldefault
site.siteAddress.organization_nameThe organization name to use in the addressoptionaldefault
site.siteAddress.postcodePostcode for the addressoptionaldefault
site.siteAddress.postcodeURIThe URI for the postcode area, uses OS open data URIsoptionaldefault
site.siteAddress.street_addressThe number and street name part of the addressoptionaldefault
site.siteTypeType of sitedefault
site.siteType.commentAn explanatory comment or description of the site.siteType.xsd:stringdefault

Data reference

Abstraction (reg:Abstraction)
A point where resource abstractions are permitted
Activity (reg:Activity)
A superclass intended to be the UNION over more specialised subclasses of Business Activities, Permitted Activities, Registered Activities (inc exemptions)
AgencyFunction (reg:AgencyFunction)
The function with the Environment Agency associated with an entry
Application (reg:Application)
An application for a permit
Permit (reg:Permit)
A permit allowing some activity to take place
Register (reg:Register)
A class for Register which may contain RegisterItems (and other Registers(??))
RegisterItem (reg:RegisterItem)
A generic Class for the items in a Register.
Registration (reg:Registration)
A entry in a Register, indicates that the holder has registered under some registration regime
Tier (reg:Tier)
A subclass of skos:Concept for registration tiers. Some registers have multiple tiers or levels which allow entries to be made at different levels within a register.
activity (reg:activity)
An activity allowed by a registration or permit typically conducted by or on behalf of the holder of the registration or permit at or from some nominated site.
agencyFunction (reg:agencyFunction)
Indicates a function within the Environment Agency associated with some action
applicant (reg:applicant)
The agent (person or organization) that applied for a permit or registration, may not be the same as the eventual holder of the registration.
application (reg:application)
A property for making reference to an Application for a Registration or Permit
applicationDate (reg:applicationDate)
The date an Application for a Permit or Registration was made
applicationRegime (reg:applicationRegime)
The regime associated a register entry (Permit or Registration) arising from an Application (rather than the regime of the register of Applications).
broker-dealer (cab:broker-dealer)
Broker Dealer regime. Brokers are inherently dealers because they trade in 3rd party waste..
cancellationDate (reg:cancellationDate)
The date on which a Permit or Registration was cancelled.
carrier (cab:carrier)
Carrier only sub-regime of "carriers-and-brokers" regime. [This seems corresponds to a lower-tier sub-regime carriers moving their own waste - @@TODO@@ CHECK THAT THIS IS APPROPRIATE]
carrier-broker-dealer (cab:carrier-broker-dealer)
Carrier Broker Dealer regime. Brokers are inherently dealers because they trade in 3rd party waste.
carrier-dealer (cab:carrier-dealer)
Carrier Dealer regime. Carrier-dealers handle waste generated by 3rd parties and are inherently dealers.
carriers-and-brokers (regime:carriers-and-brokers)
Top Level Carrier and Brokers Regime.
ceaseDate (reg:ceaseDate)
@@TODO@@ this may be the date at which the registration of ceases to be a matter of record on a register - and the item should be removed
comment (rdfs:comment)
An explanatory comment or description of the {x}.
contactAddress (reg:contactAddress)
The address given for contacting an agent (person or organization)
contactPerson (reg:contactPerson)
The specific contact person for some entry.
decisionDate (reg:decisionDate)
The date when a decision was made about the issuing of a Permit
definition (skos:definition)
The definition of the {x}.
description (dct:description)
A textual description of the {x}.
easting (spatialrelations:easting)
The easting of the point on the British National Grid
effectiveDate (reg:effectiveDate)
The date from which a Permit or Regisitration is in effect.
enforcement-action (regime:enforcement-action)
Top Level Enforcement Action Regime
eprReferenceNumber (reg:eprReferenceNumber)
Internal reference number for a permit of registration, often relates to the official reference number but may for example omit a renewal number suffix.
expiryDate (reg:expiryDate)
The current date at which the registration will expire unless it is renewed.
hasAddress (reg:hasAddress)
The address for some person or organization
holder (reg:holder)
The agent (person or organization) which holds the registration or permit.
issueDate (reg:issueDate)
The date on which a current Permit or Registration Certificate was issued.
issued (http://environment.data.gov.uk/public-register/def/status/issued)
A status that indicates that a permit or registration has been issued.
issued (http://environment.data.gov.uk/public-register/def/status/issued)
A status that indicates that a permit or registration has been issued.
label (rdfs:label)
A name for the {x}.
lat (geo:lat)
The latitude of the point in WGS84 coordinates
legislationSection (reg:legislationSection)
A literal reference to the relevant section of legislation (primary or secondary) indicated by the corresponding legislationTitle associated a register item (typically the section of legislation that defines the offence against which enforcement action is being taken).
legislationTitle (reg:legislationTitle)
The title or an common abbreviation of the title of a legislation (primary or secondary) associated a register item (typically the title of legislation that defines the offence againts which an enforcement action is being taken).
long (geo:long)
The longitude of the point in WGS84 coordinates
lower-tier (cab:lower-tier)
Lower tier regime.
member (skos:member)
A member of the group.
modificationDate (reg:modificationDate)
The date on which a Permit or Registration was modified or amended.
northing (spatialrelations:northing)
The easting of the point on the British National Grid
notation (skos:notation)
A string or other literal which uniquely identifies the {x}.
notificationDate (reg:notificationDate)
The date on the agency maintaining the register was notified of an installation requiring a Exemption
permit (reg:permit)
A property for making reference to a Permit. A sub-property of reg:registerItem.
primaryActivity (reg:primaryActivity)
The primary activity allowed by a registration or permit typically conducted by or on behalf of the holder of the registration or permit at or from some nominated site.
radioactive-substance (regime:radioactive-substance)
Top Level Radioactive Substance Regime
register (reg:register)
The Register associated with some registered item
registerItem (reg:registerItem)
A property for making reference to a RegisterItem
registration (reg:registration)
A property for making reference to a Registration. A sup-property of reg:registerItem.
registrationDate (reg:registrationDate)
The date of registration associated with a register items such as a Permit or Registration
registrationNumber (reg:registrationNumber)
A registered item's official number.
registrationType (reg:registrationType)
A property that expresses as more detailed register specific classsification or type for a registration, permit or enforcement-action (a register item)
renewalDate (reg:renewalDate)
The data at which the registration was last renewed
replaced (http://environment.data.gov.uk/public-register/def/status/replaced)
A status that indicates that a permit or registration has been replaced.
replaced (http://environment.data.gov.uk/public-register/def/status/replaced)
A status that indicates that a permit or registration has been replaced.
replacedDate (reg:replacedDate)
The date on which a Permit or Regisitration was replaced.
revocationDate (reg:revocationDate)
The date on which a Permit or Registration was revoked.
revoked (http://environment.data.gov.uk/public-register/def/status/revoked)
A status that indicates that a permit or registration has been revoked.
revoked (http://environment.data.gov.uk/public-register/def/status/revoked)
A status that indicates that a permit or registration has been revoked.
sameAs (owl:sameAs)
An alternative URI resource equivalent to this {x}.
scrap-metal-dealers (regime:scrap-metal-dealers)
Top Level Scrap Metal Dealers Licence Regime
site (reg:site)
A property for associating some thing, usually a Registration or a Permit, with a site.
surrenderDate (reg:surrenderDate)
The date on which a Permit or Registration was surrendered.
surrendered (http://environment.data.gov.uk/public-register/def/status/surrendered)
A status that indicates that a permit or registration has been surrendered.
surrendered (http://environment.data.gov.uk/public-register/def/status/surrendered)
A status that indicates that a permit or registration has been surrendered.
suspensionDate (reg:suspensionDate)
The date on which a Permit or Registration was suspended.
tier (reg:tier)
A property of a register item (registration, permit or enforcement action) that associates with its tier level within a multi-tiered register.
totalFine (reg:totalFine)
The total of all fines arising from court action in respect of a given incident.
transferDate (reg:transferDate)
The date on which a Permit or Registration was transferred to a different holder.
transferred (http://environment.data.gov.uk/public-register/def/status/transferred)
A status that indicates that a permit or registration has been transferred.
transferred (http://environment.data.gov.uk/public-register/def/status/transferred)
A status that indicates that a permit or registration has been transferred.
type (rdf:type)
The class or type of this {x}.
unit (qudt:unit)
The units in which the {x} is measured.