Measurabl Carbon Estimates API

The Carbon Estimates API from Measurabl — 7 operation(s) for carbon estimates.

Operations 8

GET /insights/v0/carbon_estimate_batches Returns all carbon estimates batches
GET /insights/v0/carbon_estimate_batches/{id}/carbon_estimates Returns all carbon estimates for a given batch
POST /insights/v0/carbon_estimate_batches/export Requests a CSV download for the given Carbon Estimate batches
GET /insights/v0/carbon_estimate_batches/{id} Returns carbon estimate batch
POST /insights/v0/carbon_estimate_batches/upload Uploads a file to create new carbon estimate(s)
GET /insights/v0/carbon_estimates Returns all carbon estimates
POST /insights/v0/carbon_estimates Creates new carbon estimate(s)
GET /insights/v0/carbon_estimates/{id} Retrieves an existing carbon estimate

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/measurabl-carbon-estimates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

measurabl-carbon-estimates-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ESGx Buildings Carbon Estimates API
  version: v0
  description: '## Quick Start Guide


    1. Authorize using your client credentials (key and secret)

    2. Make a `POST /insights/v0/energy_estimates` request with at least one building

    3. Take note of the `id` for the first estimate record

    4. Check the status of the energy estimate with `GET /insights/v0/energy_estimates/{id}`

    5. Keep polling until the status says `JOB_SUCCESS`

    6. Check out the results of the estimate in the `absoluteEstimates` and `intensityEstimates` fields!


    ### Response Format

    Each endpoint response complies with the [JSON-API Specification](https://jsonapi.org/) which has many available [client libraries](https://jsonapi.org/implementations/#client-libraries).

    '
servers:
- url: https://api.measurabl.com/insights/v0
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Carbon Estimates
paths:
  /insights/v0/carbon_estimate_batches:
    get:
      summary: Returns all carbon estimates batches
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: page
        in: query
        schema:
          type: integer
      - name: pageSize
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: list of carbon estimate batches
          content:
            application/vnd.api+json:
              example:
                data:
                - id: e9446651-d9d2-47cc-ab1f-c0f981ea7188
                  type: carbonEstimateBatches
                  attributes:
                    estimateType: carbon
                    status: STARTING
                    timePeriod: '2024'
                    errorMessage: null
                    createdAt: '2026-07-16T13:20:42.571Z'
                    updatedAt: '2026-07-16T13:20:42.571Z'
                - id: 2a88af68-a543-47c3-a1ea-9e327de2f764
                  type: carbonEstimateBatches
                  attributes:
                    estimateType: carbon
                    status: STARTING
                    timePeriod: '2023'
                    errorMessage: null
                    createdAt: '2026-07-16T13:20:42.574Z'
                    updatedAt: '2026-07-16T13:20:42.574Z'
                meta:
                  totalCount: 2
                  itemCount: 5
                  pageCount: 1
                  currentPage: 1
                  prevPage: null
                  nextPage: null
                  lastPage: 1
                  fromRecord: 1
                  toRecord: 2
                links:
                  self: /insights/v0/carbon_estimate_batches?page=1&pageSize=5
                  prev: null
                  next: null
              schema:
                $ref: '#/components/schemas/json_api'
        '404':
          description: when requesting an overflow page
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  title: Not Found
                  detail: 'The page requested was not found

                    The last page available is 1

                    '
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: unauthorized request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: 'A valid auth token is required.

                    POST to ''/token'' with a valid ''key'' and ''secret'' to get an auth token.

                    '
              schema:
                $ref: '#/components/schemas/json_api'
  /insights/v0/carbon_estimate_batches/{id}/carbon_estimates:
    get:
      summary: Returns all carbon estimates for a given batch
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: id
        in: path
        description: 'Example: <em>d271f75a-6d88-4344-a1cd-bfe6a82cb2a0</em>'
        required: true
        schema:
          type: string
      - name: page
        in: query
        schema:
          type: integer
      - name: pageSize
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: list of carbon estimates
          content:
            application/vnd.api+json:
              example:
                data:
                - id: cda747b1-74d3-4c46-b47d-e2767bc6cdbc
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:54.599Z'
                    updatedAt: '2026-07-16T13:20:54.599Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: f9a118a3-f02f-48c8-8660-3e83665541f1
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: fb872ecf-b040-4749-8d6e-a24a02a0dd13
                        type: buildings
                - id: d9cb138b-f954-45c4-b923-acdff9c7a66a
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:54.621Z'
                    updatedAt: '2026-07-16T13:20:54.621Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: f9a118a3-f02f-48c8-8660-3e83665541f1
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: ff323d10-b7da-48e9-acd7-4de08cabc731
                        type: buildings
                - id: a373cb31-f91c-43ff-84ab-3ed91342cfa2
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:54.643Z'
                    updatedAt: '2026-07-16T13:20:54.643Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: f9a118a3-f02f-48c8-8660-3e83665541f1
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: dd5e6c91-eb01-4479-bad8-936ec7a29d3a
                        type: buildings
                meta:
                  totalCount: 3
                  itemCount: 5
                  pageCount: 1
                  currentPage: 1
                  prevPage: null
                  nextPage: null
                  lastPage: 1
                  fromRecord: 1
                  toRecord: 3
                links:
                  self: /insights/v0/carbon_estimate_batches/f9a118a3-f02f-48c8-8660-3e83665541f1/carbon_estimates?page=1&pageSize=5
                  prev: null
                  next: null
              schema:
                $ref: '#/components/schemas/json_api'
        '404':
          description: when requesting an overflow page
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  title: Not Found
                  detail: 'The page requested was not found

                    The last page available is 1

                    '
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: unauthorized request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: 'A valid auth token is required.

                    POST to ''/token'' with a valid ''key'' and ''secret'' to get an auth token.

                    '
              schema:
                $ref: '#/components/schemas/json_api'
  /insights/v0/carbon_estimate_batches/export:
    post:
      summary: Requests a CSV download for the given Carbon Estimate batches
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - JOB_SUCCESS
      responses:
        '200':
          description: Export successfully created
          content:
            application/vnd.api+json:
              example:
                data:
                  id: 985ad29b-fce8-4fd5-9d77-ddc3d83db0db
                  type: exports
                  attributes:
                    status: PROCESSING
                    error: null
                    createdAt: '2026-07-16T13:20:55.222Z'
                    updatedAt: '2026-07-16T13:20:55.222Z'
                    permalink: http://localhost:3000/insights/v0/exports/0698b5d5-eac4-4865-92fc-760f1102e6cb/download
                  relationships:
                    estimateBatches:
                      data:
                      - id: 082caae3-203f-4dfb-b2d0-02e73f6598e3
                        type: energyEstimateBatches
                      - id: e9c74e65-00c9-40b4-8aff-1bea933c2b5e
                        type: energyEstimateBatches
              schema:
                $ref: '#/components/schemas/json_api'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                batchIds:
                  type: array
                  items:
                    type: string
                  example:
                  - b0d6486a-9398-42c6-9182-14eaba92d739
                  - dacb11f7-3b69-409c-9565-ce05f9869cf1
  /insights/v0/carbon_estimate_batches/{id}:
    get:
      summary: Returns carbon estimate batch
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: id
        in: path
        description: 'Example: <em>ee433e27-9d53-4c54-90c2-b57e3d2a6f98</em>'
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Carbon estimate batch record
          content:
            application/vnd.api+json:
              example:
                data:
                  id: c68303e8-418b-46ad-8b17-a91216563080
                  type: carbonEstimateBatches
                  attributes:
                    estimateType: carbon
                    status: STARTING
                    timePeriod: '2025'
                    errorMessage: null
                    createdAt: '2026-07-16T13:20:55.311Z'
                    updatedAt: '2026-07-16T13:20:55.311Z'
              schema:
                $ref: '#/components/schemas/json_api'
        '404':
          description: Carbon estimate batch record belonging to another app
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  title: Not Found
                  detail: Page not found
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: unauthorized request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: 'A valid auth token is required.

                    POST to ''/token'' with a valid ''key'' and ''secret'' to get an auth token.

                    '
              schema:
                $ref: '#/components/schemas/json_api'
  /insights/v0/carbon_estimate_batches/upload:
    post:
      summary: Uploads a file to create new carbon estimate(s)
      description: 'Upload an Excel file of carbon estimate records to be processed.

        '
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: timePeriod
        in: query
        schema:
          type: string
          description: 'A timePeriod to apply for all estimates in the batch. The valid values for timePeriod are: ["T-12", "2025", "2024", "2023", "2022", "2021"]''

            '
          enum:
          - T-12
          - '2025'
          - '2024'
          - '2023'
          - '2022'
          - '2021'
        required: true
      responses:
        '200':
          description: Carbon estimate batch successfully created
          content:
            application/vnd.api+json:
              example:
                data:
                  id: 45a13954-c7e2-4e55-8ef4-b4cb2667ed34
                  type: carbonEstimateBatches
                  attributes:
                    estimateType: carbon
                    status: STARTING
                    timePeriod: '2025'
                    errorMessage: null
                    createdAt: '2026-07-16T13:20:55.746Z'
                    updatedAt: '2026-07-16T13:20:55.756Z'
              schema:
                $ref: '#/components/schemas/json_api'
        '400':
          description: invalid time period
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '400'
                  title: Bad Request
                  detail: 'Time period requested: 3023 is not included in the list T-12, 2025, 2024, 2023, 2022, 2021; Requesting app: Bogisich and Sons'
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: unauthorized request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: 'A valid auth token is required.

                    POST to ''/token'' with a valid ''key'' and ''secret'' to get an auth token.

                    '
              schema:
                $ref: '#/components/schemas/json_api'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                estimate_batch_file:
                  type: string
                  format: binary
                  description: 'An Excel XLSX file containing the buildings you would like carbon estimates for.


                    <br>

                    When requesting data on buildings for the first time, the Excel Worksheet must be named ''Buildings''.


                    <br>

                    Building information is required for each estimate. Other fields are optional.


                    The field ''clientMetadata'' is available for storing arbitrary JSON, this allows storing identifiers from your system and other metadata as part of the carbon estimate record.


                    <br>

                    When requesting data on existing buildings i.e. you have the Building IDs, the Excel Worksheet must be named ''MSR Building IDs'' and may only contain a single column named ''MSR Building ID''.


                    '
        required: true
  /insights/v0/carbon_estimates:
    get:
      summary: Returns all carbon estimates
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters:
      - name: page
        in: query
        schema:
          type: integer
      - name: pageSize
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: list of carbon estimates
          content:
            application/vnd.api+json:
              example:
                data:
                - id: 20f40e2c-913f-4ef0-8f2d-a73d5c47557b
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:56.183Z'
                    updatedAt: '2026-07-16T13:20:56.183Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: 9c5bfef5-31ec-42bd-b3d1-8afc5b390470
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: 5c0e576c-d7f1-4341-8409-34227c624f6d
                        type: buildings
                - id: 4b191a9f-01e4-46b6-9322-5d8efc893ee8
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:56.206Z'
                    updatedAt: '2026-07-16T13:20:56.206Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: edea9e73-561a-4434-b22d-93d25db8baf7
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: 3517930d-53e9-409e-9611-e9c1c7dd15e0
                        type: buildings
                - id: 7321a2c3-eaa3-43f4-8798-51e1776b7358
                  type: carbonEstimates
                  attributes:
                    status: PROCESSING
                    error: null
                    customId: null
                    clientMetadata: null
                    createdAt: '2026-07-16T13:20:56.231Z'
                    updatedAt: '2026-07-16T13:20:56.231Z'
                    requestedLatitude: null
                    requestedLongitude: null
                    startingMonth: 2025-07
                    endingMonth: 2026-06
                  relationships:
                    estimateBatch:
                      data:
                        id: bfbadd8e-157c-4750-a28b-88a11f0a8ed8
                        type: carbonEstimateBatches
                    building:
                      data:
                        id: 97c9d41a-f814-46a2-924a-b8392660716d
                        type: buildings
                meta:
                  totalCount: 3
                  itemCount: 5
                  pageCount: 1
                  currentPage: 1
                  prevPage: null
                  nextPage: null
                  lastPage: 1
                  fromRecord: 1
                  toRecord: 3
                links:
                  self: /insights/v0/carbon_estimates?page=1&pageSize=5
                  prev: null
                  next: null
              schema:
                $ref: '#/components/schemas/json_api'
        '404':
          description: when requesting an overflow page
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '404'
                  title: Not Found
                  detail: 'The page requested was not found

                    The last page available is 1

                    '
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: unauthorized request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: 'A valid auth token is required.

                    POST to ''/token'' with a valid ''key'' and ''secret'' to get an auth token.

                    '
              schema:
                $ref: '#/components/schemas/json_api'
    post:
      summary: Creates new carbon estimate(s)
      description: 'Create new carbon estimate records to be processed. The response will include those records, including IDs that can be used to access the carbon estimate(s).


        There is a limit of 100 buildings per request. If you have over 100 buildings, please create separate requests in increments of 100 buildings or fewer.


        Please note: You can process larger collections of Buildings via the file upload endpoint.


        Coverage: Global

        '
      tags:
      - Carbon Estimates
      security:
      - OAuth2: []
      parameters: []
      responses:
        '200':
          description: Carbon estimate(s) successfully created
          content:
            application/vnd.api+json:
              examples:
                With MSR Building ID:
                  value:
                    data:
                    - id: a38c7f29-0720-47c7-baf4-5e87dfae91bb
                      type: carbonEstimates
                      attributes:
                        status: GEOLOCATION_SUCCEEDED
                        error: null
                        customId: null
                        clientMetadata: null
                        createdAt: '2026-07-16T13:20:57.548Z'
                        updatedAt: '2026-07-16T13:20:57.564Z'
                        requestedLatitude: null
                        requestedLongitude: null
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c6ca71ac-d497-4fca-af95-1f89917be2d1
                            type: carbonEstimateBatches
                        building:
                          data:
                            id: 9dcccad0-4afe-4e65-88d7-63fda2bdc467
                            type: buildings
                    - id: 3a0c79cc-4e57-47c9-953b-ddc86d580504
                      type: carbonEstimates
                      attributes:
                        status: GEOLOCATION_SUCCEEDED
                        error: null
                        customId: null
                        clientMetadata: null
                        createdAt: '2026-07-16T13:20:57.548Z'
                        updatedAt: '2026-07-16T13:20:57.584Z'
                        requestedLatitude: null
                        requestedLongitude: null
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c6ca71ac-d497-4fca-af95-1f89917be2d1
                            type: carbonEstimateBatches
                        building:
                          data:
                            id: 7a0c1cb2-85bc-49b2-b61c-801e11659494
                            type: buildings
                With Building Custom ID:
                  value:
                    data:
                    - id: c541cc4e-0f7e-410c-9228-cef5a084fc90
                      type: carbonEstimates
                      attributes:
                        status: GEOLOCATION_SUCCEEDED
                        error: null
                        customId: null
                        clientMetadata: null
                        createdAt: '2026-07-16T13:20:57.692Z'
                        updatedAt: '2026-07-16T13:20:57.710Z'
                        requestedLatitude: null
                        requestedLongitude: null
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: dd4ad0c4-a2f6-436c-88d4-c4c6a5f266fd
                            type: carbonEstimateBatches
                        building:
                          data:
                            id: 353b286a-59be-4a3d-95c6-1203a6a91119
                            type: buildings
                With Coordinates:
                  value:
                    data:
                    - id: 277ac81b-3ead-4ddb-b2f4-18f1f05fc115
                      type: carbonEstimates
                      attributes:
                        status: PROCESSING
                        error: null
                        customId: null
                        clientMetadata: null
                        createdAt: '2026-07-16T13:20:57.797Z'
                        updatedAt: '2026-07-16T13:20:57.797Z'
                        requestedLatitude: '40.766276'
                        requestedLongitude: '-73.9834504'
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: a8f7b468-e8a3-4bed-aed8-5eef8784fa17
                            type: carbonEstimateBatches
                        building:
                          data: null
                With Full Address Data:
                  value:
                    data:
                    - id: 23b11baa-5091-485b-aa8b-140d64330e80
                      type: carbonEstimates
                      attributes:
                        status: PROCESSING
                        error: null
                        customId: null
                        clientMetadata:
                          project: Midwest Analysis
                        createdAt: '2026-07-16T13:20:57.899Z'
                        updatedAt: '2026-07-16T13:20:57.899Z'
                        requestedLatitude: null
                        requestedLongitude: null
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c606a079-a620-47fd-96d8-0a281e3844f2
                            type: carbonEstimateBatches
                        building:
                          data: null
                    - id: 2a233957-2d7a-4958-9974-b4880fb0c24c
                      type: carbonEstimates
                      attributes:
                        status: PROCESSING
                        error: null
                        customId: null
                        clientMetadata:
                          project: Midwest Analysis
                        createdAt: '2026-07-16T13:20:57.899Z'
                        updatedAt: '2026-07-16T13:20:57.899Z'
                        requestedLatitude: '39.15600199'
                        requestedLongitude: '-84.4202312'
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c606a079-a620-47fd-96d8-0a281e3844f2
                            type: carbonEstimateBatches
                        building:
                          data: null
                    - id: f14c0687-091e-4868-813c-843059c91223
                      type: carbonEstimates
                      attributes:
                        status: PROCESSING
                        error: null
                        customId: null
                        clientMetadata:
                          project: Midwest Analysis
                        createdAt: '2026-07-16T13:20:57.899Z'
                        updatedAt: '2026-07-16T13:20:57.899Z'
                        requestedLatitude: '51.372512'
                        requestedLongitude: '-104.778923199'
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c606a079-a620-47fd-96d8-0a281e3844f2
                            type: carbonEstimateBatches
                        building:
                          data: null
                    - id: 5151991f-37fe-4ec1-8872-7574cc988b3f
                      type: carbonEstimates
                      attributes:
                        status: PROCESSING
                        error: null
                        customId: null
                        clientMetadata:
                          project: Midwest Analysis
                        createdAt: '2026-07-16T13:20:57.899Z'
                        updatedAt: '2026-07-16T13:20:57.899Z'
                        requestedLatitude: null
                        requestedLongitude: null
                        startingMonth: 2023-01
                        endingMonth: 2023-12
                      relationships:
                        estimateBatch:
                          data:
                            id: c606a079-a620-47fd-96d8-0a281e3844f2
                            type: carbonEstimateBatches
                        building:
                          data: null
              schema:
                $ref: '#/components/schemas/json_api'
        '413':
          description: too many estimates in request
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '413'
                  title: Payload too large
                  detail: Only 100 estimates can be created in a single request.
              schema:
                $ref: '#/components/schemas/json_api'
        '403':
          description: when authenticated but not authorized
          content:
            application/vnd.api+json:
              example:
                errors:
                - status: '403'
                  title: Forbidden
                  detail: Access Denied
              schema:
                $ref: '#/components/schemas/json_api'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                timePeriod:
                  type: string
                  enum:
                  - T-12
                  - '2025'
                  - '2024'
                  - '2023'
                  - '2022'
                  - '2021'
                estimates:
                  type: array
                  items:
                    oneOf:
                    - $ref: '#/components/schemas/request_body_msr_building_id'
                    - $ref: '#/components/schemas/request_body_building_custom_id'
                    - $ref: '#/components/schemas/request_body_coordinates_with_client_metadata'
                    - $ref: '#/components/schemas/request_body_building_info_with_client_metadata'
            examples:
              With MSR Building ID:
                summary: With MSR Building ID
                value:
                  timePeriod: '2023'
                  estimates:
                  - building:
                      msrBuildingId: 9dcccad0-4afe-4e65-88d7-63fda2bdc467
                  - building:
                      msrBuildingId: 7a0c1cb2-85bc-49b2-b61c-801e11659494
              With Building Custom ID:
                summary: With Building Custom ID
                value:
                  timePeriod: '2023'
                  estimates:
                  - building:
                      buildingCustomId: your-custom-building-id
              With Coordinates:
                summary: With Coordinates
                value:
                  timePeriod: '2023'
                  estimates:
                  - building:
                      latitude: 40.766276
                      longitude: -73.9834504
                      primaryPropertyType: Office
                      yearBuilt: 2006
                      grossFloorArea: 703796
                      gr

# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/measurabl/refs/heads/main/openapi/measurabl-carbon-estimates-api-openapi.yml