API
EPD, PCR, building project, and other data available in EC3 is also accessible via API.
Access
You must have an EC3 account in order to access the API. The information that is accessible to users via the API corresponds to the user permissions in EC3. All API users must follow the API Terms of Service.
Documentation
API documentation is available in the settings menu of EC3 under API & Integrations.
Throttling
Our API has default throttling rules to prevent misuse and overloading of the service. The system uses a combination of 1) token cost structure for performing various requests and 2) time-period token usage limits (shown below).
45 tokens per minute
400 tokens per hour
2,000 tokens per day
10,000 tokens per month
If your use case requires higher token limits, you can reach out to [email protected]
Attribution
As the Terms of Use say, we request that you display any attribution to BT's work and data when using the API for third party platforms. The following are some samples of how this can be done.
Inline links to EC3
If you are showing individual EC3 data directly in a search and list fashion, please provide direct links back to the original source in EC3. This can be either in the list view as shown in the example below, or on the detailed view of the individual datapoint.
Customer communication
If you are communicating with customers about data originating from EC3, please acknowledge Building Transparency and EC3 in the email referencing our data.
Documentation
If EC3 data is not provided directly but is used to develop other data, it is sufficient to attribute Building Transparency and EC3 in your tool’s documentation or user guide.
Last updated