Cloverly

Cloverly Purchases API

Purchase and retire carbon offsets from Cloverly's curated marketplace. Mirrors the Estimates shape (shipping, vehicle, flight, electricity, carbon, currency) but immediately reserves and retires credits against a verified project. Estimates can be promoted to purchases by posting their slug.

Documentation GitHub OpenAPI

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/cloverly-purchases-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.1.0
info:
  title: Cloverly Account Purchases API
  description: 'Retrieve the authenticated account record — currency, default offset preferences, and the API key context (public vs private, sandbox vs production).

    '
  version: 2019-03-beta
  contact:
    name: Cloverly Support
    url: https://cloverly.com/contact
  license:
    name: Cloverly Terms of Service
    url: https://cloverly.com/terms-of-service
servers:
- url: https://api.cloverly.com
  description: Production server
security:
- BearerAuth: []
tags:
- name: Purchases
  description: Retire carbon offsets and produce auditable purchase records
paths:
  /2019-03-beta/purchases:
    get:
      summary: Cloverly List Purchases
      description: List purchases recorded against the authenticated account.
      operationId: listPurchases
      tags:
      - Purchases
      responses:
        '200':
          description: A list of purchase records.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Purchase'
    post:
      summary: Cloverly Convert Estimate To Purchase
      description: Promote a previously created estimate to a purchase by posting its slug.
      operationId: convertEstimateToPurchase
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - estimate_slug
              properties:
                estimate_slug:
                  type: string
      responses:
        '200':
          description: The purchased offset record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/{slug}:
    get:
      summary: Cloverly Retrieve Purchase
      description: Retrieve a single purchase by slug.
      operationId: retrievePurchase
      tags:
      - Purchases
      parameters:
      - $ref: '#/components/parameters/PurchaseSlug'
      responses:
        '200':
          description: The purchase record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
    delete:
      summary: Cloverly Cancel Purchase
      description: Cancel a purchase (subject to Cloverly's cancellation window).
      operationId: cancelPurchase
      tags:
      - Purchases
      parameters:
      - $ref: '#/components/parameters/PurchaseSlug'
      responses:
        '200':
          description: The cancelled purchase record.
  /2019-03-beta/purchases/shipping:
    post:
      summary: Cloverly Purchase Shipping Offset
      description: Estimate and immediately retire offsets for a shipping activity.
      operationId: purchaseShipping
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShippingRequest'
      responses:
        '200':
          description: A purchased shipping offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/vehicle:
    post:
      summary: Cloverly Purchase Vehicle Offset
      description: Estimate and immediately retire offsets for vehicle travel.
      operationId: purchaseVehicle
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VehicleRequest'
      responses:
        '200':
          description: A purchased vehicle offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/flights:
    post:
      summary: Cloverly Purchase Flight Offset
      description: Estimate and immediately retire offsets for one or more flight legs.
      operationId: purchaseFlight
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FlightRequest'
      responses:
        '200':
          description: A purchased flight offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/electricity:
    post:
      summary: Cloverly Purchase Electricity Offset
      description: Estimate and immediately retire offsets for electricity consumption.
      operationId: purchaseElectricity
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ElectricityRequest'
      responses:
        '200':
          description: A purchased electricity offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/carbon:
    post:
      summary: Cloverly Purchase Carbon Offset
      description: Estimate and immediately retire offsets for a direct mass of CO2-equivalent emissions.
      operationId: purchaseCarbon
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CarbonRequest'
      responses:
        '200':
          description: A purchased carbon offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
  /2019-03-beta/purchases/currency:
    post:
      summary: Cloverly Purchase Currency Offset
      description: Retire offsets corresponding to a fixed currency spend.
      operationId: purchaseCurrency
      tags:
      - Purchases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CurrencyRequest'
      responses:
        '200':
          description: A purchased currency-based offset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
components:
  schemas:
    Purchase:
      type: object
      properties:
        slug:
          type: string
        state:
          type: string
          enum:
          - purchased
          - cancelled
        total_co2e_in_grams:
          type: number
        total_cost_in_usd_cents:
          type: integer
        transaction_cost_in_usd_cents:
          type: integer
        offset_cost_in_usd_cents:
          type: integer
        offset:
          $ref: '#/components/schemas/Offset'
        retirement:
          type: object
          properties:
            serial_number:
              type: string
            registry_url:
              type: string
              format: uri
            retired_at:
              type: string
              format: date-time
        receipt_url:
          type: string
          format: uri
        pretty_url:
          type: string
          format: uri
        created_at:
          type: string
          format: date-time
    ShippingRequest:
      type: object
      properties:
        to:
          $ref: '#/components/schemas/Place'
        from:
          $ref: '#/components/schemas/Place'
        distance:
          $ref: '#/components/schemas/Distance'
        weight:
          $ref: '#/components/schemas/Weight'
    Weight:
      type: object
      required:
      - value
      - units
      properties:
        value:
          type: number
        units:
          type: string
          enum:
          - g
          - kg
          - pounds
          - tonnes
          - mt
    Place:
      type: object
      properties:
        zip:
          type: string
        postal_code:
          type: string
        country:
          type: string
        city:
          type: string
        state:
          type: string
    CarbonRequest:
      type: object
      properties:
        weight:
          $ref: '#/components/schemas/Weight'
    Distance:
      type: object
      required:
      - value
      - units
      properties:
        value:
          type: number
        units:
          type: string
          enum:
          - meters
          - km
          - miles
    FuelEfficiency:
      type: object
      required:
      - value
      - units
      - of
      properties:
        value:
          type: number
        units:
          type: string
          enum:
          - mpg
          - km/l
          - l/100km
        of:
          type: string
          enum:
          - gasoline
          - diesel
    VehicleRequest:
      type: object
      properties:
        to:
          $ref: '#/components/schemas/Place'
        from:
          $ref: '#/components/schemas/Place'
        distance:
          $ref: '#/components/schemas/Distance'
        fuel_efficiency:
          $ref: '#/components/schemas/FuelEfficiency'
    Offset:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        registry_name:
          type: string
        offset_type:
          type: string
        country:
          type: string
        vintage_year:
          type: integer
        price_per_kg_in_usd_cents:
          type: number
    FlightRequest:
      type: object
      properties:
        airports:
          type: array
          items:
            type: object
            properties:
              iata:
                type: string
        passengers:
          type: integer
        cabin_class:
          type: string
          enum:
          - economy
          - business
          - first
    ElectricityRequest:
      type: object
      properties:
        energy:
          type: object
          required:
          - value
          - units
          properties:
            value:
              type: number
            units:
              type: string
              enum:
              - kwh
              - mwh
        country:
          type: string
        region:
          type: string
    Currency:
      type: object
      required:
      - value
      - units
      properties:
        value:
          type: number
        units:
          type: string
          enum:
          - usd
          - usd cents
    CurrencyRequest:
      type: object
      properties:
        currency:
          $ref: '#/components/schemas/Currency'
  parameters:
    PurchaseSlug:
      name: slug
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer