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 2 APIs on the APIs.io network: MagicMatch by LiquiDonate and ReturnsDirect by LiquiDonate (Beta). Tagged areas include Reverse Logistics, Returns Management, Donations, Nonprofits, 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 33 more developer resources.

52.9/100 developing Agent 64/100 agent native Full breakdown ↓
scored 2026-07-20 · rubric v0.4
2 APIs 0 Features
Reverse LogisticsReturns ManagementDonationsNonprofitsRetailEcommerceSustainabilityCircular EconomyShippingSupply ChainExcess InventoryCompany

API Rating

API Evangelist API Evangelist Rating How this is scored →
scored 2026-07-20 · rubric v0.4
Composite quality — 52.9/100 · developing
Contract Quality 16.2 / 25
Developer Ergonomics 13.9 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 3.1 / 13
Governance 1.6 / 12
Discoverability 9.3 / 10
Agent readiness — 64/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
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

MagicMatch by LiquiDonate

Donation-as-a-Service API. Send parcel and item details to LiquiDonate and receive a matched nearby nonprofit plus a purchased donation shipping label. Built for returns platfor...

ReturnsDirect by LiquiDonate (Beta)

Returns-management integration API for non-Shopify ecommerce platforms, retail brands and custom returns portals. Retailers push order data to LiquiDonate so the customer-facing...

Event Specifications

ReturnsDirect by LiquiDonate - Return and Refund Events

Outbound webhook event surface for ReturnsDirect by LiquiDonate. LiquiDonate POSTs return and refund status events to the webhook URL a retailer registers, so the retailer can u...

ASYNCAPI

Resources

Get Started 5

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Scroll for all 7

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 3

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 9

The organization behind the API

Scroll for all 9

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
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.'
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.20'
created: '2026-07-17'
modified: '2026-07-19'
tags:
- Reverse Logistics
- Returns Management
- Donations
- Nonprofits
- Retail
- Ecommerce
- Sustainability
- Circular Economy
- Shipping
- Supply Chain
- Excess Inventory
- Company
apis:
- aid: liquidonate:magicmatch
  name: MagicMatch by LiquiDonate
  description: Donation-as-a-Service API. Send parcel and item details to LiquiDonate and receive a matched nearby nonprofit
    plus a purchased donation shipping label. Built for returns platforms, warehouse systems, 3PLs and reverse-logistics providers.
    Endpoints cover retailer setup, match-only, match-and-ship, rate estimation, fixed-address shipping, attaching your own
    labels, and bulky or pickup-scheduled donations.
  humanURL: https://docs-magicmatch.liquidonate.com
  baseURL: https://api.liquidonate.com
  tags:
  - Donations
  - Nonprofits
  - Shipping
  - Returns Management
  - Reverse Logistics
  properties:
  - url: https://docs-magicmatch.liquidonate.com
    type: Documentation
  - url: https://docs-magicmatch.liquidonate.com
    type: APIReference
  - url: openapi/liquidonate-magicmatch-openapi.yml
    type: OpenAPI
  - url: overlays/liquidonate-magicmatch-overlay.yaml
    type: Overlay
  - url: https://documenter.getpostman.com/view/21205794/2sA3QteBZu
    type: Postman
- aid: liquidonate:returnsdirect
  name: ReturnsDirect by LiquiDonate (Beta)
  description: Returns-management integration API for non-Shopify ecommerce platforms, retail brands and custom returns portals.
    Retailers push order data to LiquiDonate so the customer-facing return portal can resolve returns without calling the
    retailer API, and LiquiDonate posts HMAC-signed return and refund status events back. Optionally exposes a zero-config
    order-lookup contract in the canonical ReturnsDirect camelCase shape.
  humanURL: https://docs-returns.liquidonate.com
  baseURL: https://returns.liquidonate.com
  tags:
  - Returns Management
  - Ecommerce
  - Webhooks
  - Orders
  - Refunds
  properties:
  - url: https://docs-returns.liquidonate.com
    type: Documentation
  - url: https://docs-returns.liquidonate.com
    type: APIReference
  - url: openapi/liquidonate-returnsdirect-openapi.yml
    type: OpenAPI
  - url: overlays/liquidonate-returnsdirect-overlay.yaml
    type: Overlay
  - url: asyncapi/liquidonate-returnsdirect-asyncapi.yml
    type: AsyncAPI
  - url: https://documenter.getpostman.com/view/28612413/2sBXierZMP
    type: Postman
common:
- 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