How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Measurabl Core API

Read and write the ESG data core of the Measurabl platform: portfolios, buildings, spaces, funds, energy and water meters and their readings and bills, waste meters and readings, green building certifications and certification types, and ratings (including space-level certifications and ratings). JSON:API over OAuth 2.0 client credentials; 57 operations across 32 paths.

This API exposes 57 operations across 32 paths, organized into 16 resource areas, and defines 19 schemas. It is described by OpenAPI 3.0.1, at version v0.

Requests are made against the base URL https://api.measurabl.com/core/v0.

57 operations 32 paths 19 schemas 9 DELETE28 GET11 PATCH9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v0
Base URL
https://api.measurabl.com/core/v0
Authentication
OAuth 2.0
Resource Areas
16

Authentication & Security 1

Measurabl Core API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the clientCredentials flow.

Paths & Operations 57

Across 32 paths, the API surfaces 57 operations — 9 DELETE, 28 GET, 11 PATCH, 9 POST. They span 16 resource areas, including Buildings, Certification Types, Certifications, Space Certifications, Funds Buildings, Funds, Energy and Water Meters, Energy and Water Meter Bills, and 8 more. Each is listed below with its method, path, parameters, and response codes.

Buildings 5
POST
/core/v0/portfolios/{portfolio_id}/buildings
Adds a building to a specified portfolio
1 param body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings
Returns a paginated list of buildings for a specified portfolio or fund
4 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}
Removes a building from a specified portfolio
2 params → 204404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}
Returns details of a specific building for a specified portfolio or fund
2 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}
Updates a building's attributes in a specified portfolio
2 params body → 200404401400502500503408
Certification Types 1
GET
/core/v0/portfolios/{portfolio_id}/certification_types
Returns a list of all relevant certifications for a specified portfolio
3 params → 200404401400502500503408
Certifications 6
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications
Creates a certification for a specified building
2 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications
Returns a specified buildings list of certifications
4 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications/{certification_id}
Deletes a specific certification for a specified building
3 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications/{certification_id}
Returns a specific certification for a specific building
3 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications/{certification_id}
Updates a specific certification for a specified building
3 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/certifications
Returns a list of certifications for a specified portfolio
4 params → 200404401400502500503408
Space Certifications 2
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/certifications/{certification_id}/relationships
Assigns a specific certification to a specified space or list of spaces
3 params body → 204404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces/{space_id}/certifications
Returns a list of certifications for a specific space in a specified building
6 params → 200404401400502500503408
Funds Buildings 1
PATCH
/core/v0/portfolios/{portfolio_id}/funds/{fund_id}/relationships
Assigns existing buildings to a specific fund in a specified portfolio
2 params body → 204404401400502500503408
Funds 4
POST
/core/v0/portfolios/{portfolio_id}/funds
Creates a new fund for a specified portfolio
1 param body → 200400500401429502408404
GET
/core/v0/portfolios/{portfolio_id}/funds
Returns a list of all funds for a specified portfolio
1 param → 200400500401429502408404
DELETE
/core/v0/portfolios/{portfolio_id}/funds/{fund_id}
Deletes a specific fund in a specified portfolio
2 params → 204400500401429502408404
GET
/core/v0/portfolios/{portfolio_id}/funds/{fund_id}
Returns details of a specific fund in a specified portfolio
2 params → 200400500401429502408404
Energy and Water Meters 6
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters
Creates an energy or water meter for a specified building
2 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters
Returns a list of meters (energy or water) for a specified building
5 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}
Deletes a specific meter for a specified building
3 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}
Returns details of a specific meter (energy or water) for a specified building
3 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}
Updates a specific meter for a specified building
3 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/meters
Returns a list of meters (energy or water) for a specified portfolio
4 params → 200404401400502500503408
Energy and Water Meter Bills 1
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings/{meter_reading_id}/bill
Retrieves a utility bill for the given reading if one exists
4 params → 303404401400502500503408
Energy and Water Meter Readings 5
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings
Creates an energy or water meter reading for a specified building
3 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings
Returns a list of meter readings for a specified meter and building
6 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings/{meter_reading_id}
Deletes a specific meter reading for a specified meter and building
4 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings/{meter_reading_id}
Returns details of a specific meter reading for a specified meter and building
4 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/readings/{meter_reading_id}
Updates a specific meter reading for a specified meter and building
4 params body → 200404401400502500503408
Energy and Water Meter Spaces 2
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/spaces
Returns a list of spaces a specified energy or water meter serves
6 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/meters/{meter_id}/relationships
Assigns an existing energy or water meter to a specified space or list of spaces
3 params body → 204404401400502500503408
Ratings 4
GET
/core/v0/portfolios/{portfolio_id}/ratings
Returns a list of all ratings for a specified portfolio
4 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/ratings/{rating_id}
Deletes a specific rating assigned to a specified building
3 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/ratings/{rating_id}
Returns a specific rating for a specified building
3 params → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/ratings
Returns a list of ratings for the specified building
4 params → 200404401400502500503408
Waste Meters 6
GET
/core/v0/portfolios/{portfolio_id}/waste_meters
Returns a list of waste meters for a specified portfolio
4 params → 200404401400502500503408
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters
Creates a waste meter for a specified building
2 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters
Returns a list of waste meters for a specified building
5 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}
Deletes a specific waste meter for a specified building
3 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}
Returns a specific waste meter for a specified building
3 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}
Updates a specific waste meter for a specified building
3 params body → 200404401400502500503408
Portfolios 3
POST
/core/v0/portfolios
Creates a new portfolio for a specified account
body → 200400500401429502408404
GET
/core/v0/portfolios
Returns a list of portfolios for a specified account
2 params → 200400500401429502408404
PATCH
/core/v0/portfolios/{portfolio_id}
Update a specific portfolio's name for a specified account
1 param body → 200400500401429502408404
Space Ratings 1
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces/{space_id}/ratings
Returns a list of ratings for a specific space in a specified building
6 params → 200404401400502500503408
Spaces 5
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces
Creates space for a specified building
2 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces
Returns a list of spaces for a specified building
4 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces/{space_id}
Deletes a specific space for a specified building
3 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces/{space_id}
Returns details of a specific space for a specified building
3 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/spaces/{space_id}
Updates a specific space for a specified building
3 params body → 200404401400502500503408
Waste Meter Readings 5
POST
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}/readings
Creates a waste meter reading for a specified building
3 params body → 200404401400502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}/readings
Returns a list of waste meter readings for a specified waste meter and building
6 params → 200404401400502500503408
DELETE
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}/readings/{waste_meter_reading_id}
Deletes a specific waste meter reading for a specified waste meter and building
4 params → 204400404401502500503408
GET
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}/readings/{waste_meter_reading_id}
Returns details of a specific waste meter reading for a specified waste meter and building
4 params → 200404401400502500503408
PATCH
/core/v0/portfolios/{portfolio_id}/buildings/{building_id}/waste_meters/{waste_meter_id}/readings/{waste_meter_reading_id}
Updates a specific waste meter reading for a specified building
4 params body → 200404401400502500503408

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are error (8 properties), resource (6 properties), success (5 properties), failure (4 properties). Each schema is shown below with its type and property counts.

json_api
success
object
5 properties 1 required
failure
object
4 properties 1 required
info
object
3 properties 1 required
meta
object
Non-standard meta-information that can not be represented as an attribute or relationship.
data
The document's 'primary data' is a representation of the resource or collection of resources targeted by a request.
resource
object
'Resource objects' appear in a JSON:API document to represent resources.
6 properties 2 required
relationshipLinks
object
A resource object MAY contain references to other resource objects ('relationships'). Relationships may be to-one or to-many. Relationships can be specified by…
2 properties
links
object
link
A link MUST be represented as either: a string containing the link's URL or a link object.
attributes
object
Members of the attributes object ('attributes') represent information about the resource object in which it's defined.
relationships
object
Members of the relationships object ('relationships') represent references from the resource object in which it's defined to other resource objects.
3 properties
relationshipToOne
References to other resource objects in a to-one ('relationship'). Relationships can be specified by including a member in a resource's links object.
relationshipToMany
array
An array of objects each containing 'type' and 'id' members for to-many relationships.
empty
Describes an empty to-one relationship.
linkage
object
The 'type' and 'id' to non-empty members.
3 properties 2 required
pagination
object
4 properties
jsonapi
object
An object describing the server's implementation
2 properties
error
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

measurabl-core-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Measurabl Core API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.