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 5 APIs on the APIs.io network, including Donate API, Match API, Orders API, and 2 more. 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.

🌐 Visit website 📡 Source on GitHub

56.2/100 strong ▬ flat Agent 51/100 agent ready Full breakdown ↓
scored 2026-08-10 · rubric v0.9.1

AccessSelf serve

5 APIs

Reverse LogisticsReturns ManagementDonationsNonprofitsRetailEcommerceSustainabilityCircular EconomyShippingSupply ChainExcess InventoryCompany

Kin Score

Kin Score How this is scored →
scored 2026-08-10 · rubric v0.9.1

Composite quality — 56.2/100 · strong

Contract Quality 19.4 / 25

Developer Ergonomics 12.9 / 20

Commercial Clarity 8.9 / 20

Operational Transparency 3.1 / 13

Governance 2.6 / 12

Discoverability 9.3 / 10

Agent readiness — 51/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

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 4 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

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 5

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

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 4

MCP servers, agent skills, and machine-readable catalogs

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 2

Properties that don't map to a standard resource type

CaseStudies

CaseStudies

Marketplace

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.'
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.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: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:
  - 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
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

LiquiDonate

Kin Score

APIs 5

LiquiDonate Donate API

LiquiDonate Match API

LiquiDonate Orders API

LiquiDonate Retailer API

LiquiDonate Ship API

Event Specifications 1

ReturnsDirect by LiquiDonate - Return and Refund Events

Security Posture 2

Liquidonate Authentication

Liquidonate Domain Security

Agentic Access 1

Liquidonate Agentic Access

Resources