LiquiDonate

LiquiDonate is a San Francisco based reverse-logistics and donation-disposition platform that turns retail returns, excess inventory and unsellable goods into local nonprofit donations instead of landfill or liquidation. Its matching engine pairs items with nearby nonprofits that want them, buys the shipping label, routes the parcel and generates the donation receipt, so retailers recover tax value and meet extended-producer-responsibility and sustainability obligations. The company sells three product lines - ReturnsDirect (customer-direct returns), WarehouseDirect (warehouse and 3PL excess inventory) and BoxDrop (donation boxes) - and exposes two public developer APIs: MagicMatch, a donation-as-a-service API that accepts parcel and item details and returns a nonprofit match plus a donation shipping label, and ReturnsDirect, a beta returns-management integration for non-Shopify ecommerce platforms built on pushed order data plus HMAC-signed return and refund webhooks. LiquiDonate integrates with Shopify, Loop, EasyPost, FedEx, Bungii, SendGrid and Rise AI, and has been recognized on TIME Best Inventions 2025 and Fast Company World Changing Ideas.

LiquiDonate publishes 6 APIs on the APIs.io network, including Donate API, Match API, Orders API, and 3 more. Tagged areas include Reverse Logistics, Returns Management, Donations, Non-Profit, and Retail.

The LiquiDonate catalog on APIs.io includes 1 event-driven AsyncAPI specification.

LiquiDonate’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 36 more developer resources.

🌐 Visit website 📡 Source on GitHub

52.5/100 developing ▬ flat Agent 33/100 agent ready saas Full breakdown ↓
scored 2026-08-30 · rubric v0.17.2

AccessSelf serve

2 APIs 1 MCP Servers

Reverse Logistics Returns Management Donations Non-Profit Retail E-Commerce Sustainability Circular Economy Shipping Supply ChainExcess InventoryCompany

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Sustainability Management

BC-740

Donate

POST /v1/donate

Kin Score

Kin Score How this is scored →
scored 2026-08-30 · rubric v0.17.2

Composite quality — 52.5/100 · developing

Contract Quality 16.4 / 25

Developer Ergonomics 14.2 / 20

Access Clarity 8.9 / 20

Operational Transparency 3.1 / 13

Contract Governance 2.4 / 12

Discoverability 7.6 / 10

Agent readiness — 33/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 0 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/liquidonate: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Get Started 5

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

SignUp

SignUp

Login

Sandbox

Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

MCPServer

AgenticAccess

WellKnown

LLMsTxt

AgentSkill

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Vocabulary

Conventions

ErrorCatalog

Lifecycle

Conformance

DataModel

Webhooks

Scroll for all 7

Build 2

SDKs, sample code, and the tooling you integrate with

Postman

Postman

Packages

Packages

Access & Security 2

Authentication, authorization, and security posture

Authentication

Authentication

DomainSecurity

DomainSecurity

Learn 1

Tutorials, courses, talks, and written guidance

YouTube

YouTube

Operate 3

Status, limits, changes, and where to get help

Support

Support

Contact

Contact

StatusPage

StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 9

The organization behind the API

Website

Blog

About

Press

Careers

LinkedIn

Twitter

Twitter

Instagram

Instagram

Facebook

Facebook

Scroll for all 9

Other 4

Properties that don't map to a standard resource type

CapabilityMap

Overlay

CaseStudies

Marketplace

Source (apis.yml)

aid: liquidonate
name: LiquiDonate
description: 'LiquiDonate is a San Francisco based reverse-logistics and donation-disposition platform that turns retail returns,
  excess inventory and unsellable goods into local nonprofit donations instead of landfill or liquidation. Its matching engine
  pairs items with nearby nonprofits that want them, buys the shipping label, routes the parcel and generates the donation
  receipt, so retailers recover tax value and meet extended-producer-responsibility and sustainability obligations. The company
  sells three product lines - ReturnsDirect (customer-direct returns), WarehouseDirect (warehouse and 3PL excess inventory)
  and BoxDrop (donation boxes) - and exposes two public developer APIs: MagicMatch, a donation-as-a-service API that accepts
  parcel and item details and returns a nonprofit match plus a donation shipping label, and ReturnsDirect, a beta returns-management
  integration for non-Shopify ecommerce platforms built on pushed order data plus HMAC-signed return and refund webhooks.
  LiquiDonate integrates with Shopify, Loop, EasyPost, FedEx, Bungii, SendGrid and Rise AI, and has been recognized on TIME
  Best Inventions 2025 and Fast Company World Changing Ideas.'
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://cdn.prod.website-files.com/672dc2792e95c584b8beaaca/6739416b527eda8f246a7686_Liquidonate%20%20Webclip.png
url: https://raw.githubusercontent.com/api-evangelist/liquidonate/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- uncork-capital
x-tier: enriched
x-tier-reason: two public developer APIs documented, reconstructed and verified live
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-07-19'
tags:
- Reverse Logistics
- Returns Management
- Donations
- Non-Profit
- Retail
- E-Commerce
- Sustainability
- Circular Economy
- Shipping
- Supply Chain
- Excess Inventory
- Company
tags_raw:
- Reverse Logistics
- Returns Management
- Donations
- Nonprofits
- Retail
- Ecommerce
- Sustainability
- Circular Economy
- Shipping
- Supply Chain
- Excess Inventory
- Company
apis:
- aid: liquidonate:liquidonate-donate-api
  name: LiquiDonate Donate API
  description: Bulky, multi-package and pickup-scheduled donations.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Donate
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-donate-api-openapi.yml
  - type: Documentation
    url: https://docs-magicmatch.liquidonate.com
  - type: APIReference
    url: https://docs-magicmatch.liquidonate.com
  - type: Postman
    url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  - type: Documentation
    url: https://docs-returns.liquidonate.com
  - type: APIReference
    url: https://docs-returns.liquidonate.com
  - type: AsyncAPI
    url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
- aid: liquidonate:liquidonate-match-api
  name: LiquiDonate Match API
  description: Match items to nonprofits.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Match
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-match-api-openapi.yml
  - type: Documentation
    url: https://docs-magicmatch.liquidonate.com
  - type: APIReference
    url: https://docs-magicmatch.liquidonate.com
  - type: Postman
    url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  - type: Documentation
    url: https://docs-returns.liquidonate.com
  - type: APIReference
    url: https://docs-returns.liquidonate.com
  - type: AsyncAPI
    url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
- aid: liquidonate:liquidonate-orders-api
  name: LiquiDonate Orders API
  description: Push order data into ReturnsDirect.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Order
  tags_raw:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-orders-api-openapi.yml
  - type: Documentation
    url: https://docs-magicmatch.liquidonate.com
  - type: APIReference
    url: https://docs-magicmatch.liquidonate.com
  - type: Postman
    url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  - type: Documentation
    url: https://docs-returns.liquidonate.com
  - type: APIReference
    url: https://docs-returns.liquidonate.com
  - type: AsyncAPI
    url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
- aid: liquidonate:liquidonate-retailer-api
  name: LiquiDonate Retailer API
  description: Retailer account setup and lookup.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Retailer
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-retailer-api-openapi.yml
  - type: Documentation
    url: https://docs-magicmatch.liquidonate.com
  - type: APIReference
    url: https://docs-magicmatch.liquidonate.com
  - type: Postman
    url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  - type: Documentation
    url: https://docs-returns.liquidonate.com
  - type: APIReference
    url: https://docs-returns.liquidonate.com
  - type: AsyncAPI
    url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
- aid: liquidonate:liquidonate-ship-api
  name: LiquiDonate Ship API
  description: Purchase donation shipping labels.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Ship
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-ship-api-openapi.yml
  - type: Documentation
    url: https://docs-magicmatch.liquidonate.com
  - type: APIReference
    url: https://docs-magicmatch.liquidonate.com
  - type: Postman
    url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  - type: Documentation
    url: https://docs-returns.liquidonate.com
  - type: APIReference
    url: https://docs-returns.liquidonate.com
  - type: AsyncAPI
    url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
- aid: liquidonate:liquidonate-returnsdirect-by-liquidonate-beta-api
  name: LiquiDonate ReturnsDirect By LiquiDonate (Beta) API
  description: The ReturnsDirect By LiquiDonate (Beta) API from LiquiDonate — 0 operation(s) for returnsdirect by liquidonate
    (beta).
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - ReturnsDirect By LiquiDonate (Beta)
  properties:
  - type: OpenAPI
    url: openapi/liquidonate-returnsdirect-by-liquidonate-beta-api-openapi.yml
common:
- type: CapabilityMap
  url: capabilities/liquidonate-capability-edges.yml
  name: LiquiDonate Business Capability Map
- type: MCPServer
  url: mcp/liquidonate-mcp.yml
- type: Overlay
  url: overlays/liquidonate-magicmatch-overlay.yaml
- type: AgenticAccess
  url: agentic-access/liquidonate-agentic-access.yml
- url: https://www.liquidonate.com
  type: Website
- url: https://docs.liquidonate.com
  type: DeveloperPortal
- url: https://docs.liquidonate.com
  type: Documentation
- url: https://docs.liquidonate.com
  type: APIReference
- url: https://www.liquidonate.com/integrations
  type: GettingStarted
- url: https://help.liquidonate.com
  type: Support
- url: https://www.liquidonate.com/blog
  type: Blog
- url: https://www.liquidonate.com/pricing
  type: Pricing
- url: https://app.liquidonate.com/login
  type: SignUp
- url: https://app.liquidonate.com/login
  type: Login
- url: https://www.liquidonate.com/terms-of-service
  type: TermsOfService
- url: https://www.liquidonate.com/privacy-policy
  type: PrivacyPolicy
- url: https://www.liquidonate.com/contact-us
  type: Contact
- url: https://www.liquidonate.com/about
  type: About
- url: https://www.liquidonate.com/press
  type: Press
- url: https://www.liquidonate.com/case-studies
  type: CaseStudies
- url: https://www.liquidonate.com/integrations
  type: Integrations
- url: https://apps.shopify.com/liquidonate
  type: Marketplace
- url: https://jobs.gusto.com/boards/liquidonate-inc-6984f107-b115-40e9-8c73-432c4902cff4
  type: Careers
- url: https://www.linkedin.com/company/liquidonate
  type: LinkedIn
- url: https://twitter.com/liquidonate
  type: Twitter
- url: https://www.youtube.com/@LiquiDonate
  type: YouTube
- url: https://www.instagram.com/liquidonate
  type: Instagram
- url: https://www.facebook.com/liquidonate
  type: Facebook
- url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
  type: Postman
  name: MagicMatch published Postman collection
- url: vocabulary/liquidonate-category-types.yml
  type: Vocabulary
- url: authentication/liquidonate-authentication.yml
  type: Authentication
- url: conventions/liquidonate-conventions.yml
  type: Conventions
- url: errors/liquidonate-problem-types.yml
  type: ErrorCatalog
- url: lifecycle/liquidonate-lifecycle.yml
  type: Lifecycle
- url: https://status.liquidonate.com/
  type: StatusPage
- url: conformance/liquidonate-conformance.yml
  type: Conformance
- url: data-model/liquidonate-data-model.yml
  type: DataModel
- url: sandbox/liquidonate-sandbox.yml
  type: Sandbox
- url: packages/liquidonate-packages.yml
  type: Packages
- url: well-known/liquidonate-well-known.yml
  type: WellKnown
- url: security/liquidonate-domain-security.yml
  type: DomainSecurity
- url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
  type: Webhooks
- url: llms/liquidonate-llms.txt
  type: LLMsTxt
- url: skills/_index.yml
  type: AgentSkill
integrations:
- name: Shopify
  description: Ecommerce platform. LiquiDonate ships a public Shopify application.
  url: https://apps.shopify.com/liquidonate
- name: Loop
  description: Returns platform. Handles and tracks returns for reuse, repair or recycling.
  url: https://www.liquidonate.com/partner/loop
- name: EasyPost
  description: Shipping API used for label creation, tracking and carrier integration.
  url: https://www.liquidonate.com/integrations
- name: FedEx
  description: Carrier for shipping, transportation and delivery.
  url: https://www.liquidonate.com/integrations
- name: Bungii
  description: On-demand delivery service specializing in large-item transportation.
  url: https://www.liquidonate.com/integrations
- name: SendGrid
  description: Email delivery platform for transactional and marketing email.
  url: https://www.liquidonate.com/integrations
- name: Rise AI
  description: Customer gift-card platform for ecommerce.
  url: https://www.liquidonate.com/integrations
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence

Work with this as data

Every provider 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 providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
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 provider

curl "https://apis.io/api/v1/providers/liquidonate"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/liquidonate/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/liquidonate/evidence"

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.