Cratejoy

Cratejoy is a subscription-box commerce platform and marketplace (a CRV and Y Combinator company) that lets independent creators launch, sell, and manage recurring subscription boxes and one-time products. It exposes two public REST APIs: a Merchant API (https://api.cratejoy.com/v1/) covering customers, orders, subscriptions, shipments, products, inventory, carts, transactions, and webhooks; and a front-end Store API for reading and writing customer-scoped data from a storefront theme. Resources are JSON, authenticated with HTTP Basic credentials, paginated, filterable with double-underscore operators, and rate-limited with Retry-After.

Cratejoy publishes 2 APIs on the APIs.io network. Tagged areas include Company, Ecommerce, Subscriptions, Subscription Boxes, and Marketplace.

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

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

33.6/100 thin Agent 35/100 agent aware Full breakdown ↓
scored 2026-07-20 · rubric v0.4
2 APIs 1 MCP Servers 0 Features
CompanyEcommerceSubscriptionsSubscription BoxesMarketplacePaymentsOrdersWebhooksREST

API Rating

API Evangelist API Evangelist Rating How this is scored →
scored 2026-07-20 · rubric v0.4
Composite quality — 33.6/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 3.8 / 13
Governance 0.0 / 12
Discoverability 8.8 / 10
Agent readiness — 35/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 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 0 / 5
Well-Known Catalog 0 / 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/cratejoy: 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

Cratejoy Merchant API

REST interface into most of the data and functionality of interest to Cratejoy merchants and developers: customers, orders, subscriptions, shipments, products, inventory, carts,...

Cratejoy Store API

Front-end API that lets storefront JavaScript read (and sometimes write) data on behalf of the logged-in customer: customer, product, subscription, shipment, address, and survey...

MCP Servers

cratejoy-mcp.yml

MCP SERVER

Event Specifications

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: cratejoy
name: Cratejoy
description: 'Cratejoy is a subscription-box commerce platform and marketplace (a CRV and Y Combinator company) that lets
  independent creators launch, sell, and manage recurring subscription boxes and one-time products. It exposes two public
  REST APIs: a Merchant API (https://api.cratejoy.com/v1/) covering customers, orders, subscriptions, shipments, products,
  inventory, carts, transactions, and webhooks; and a front-end Store API for reading and writing customer-scoped data from
  a storefront theme. Resources are JSON, authenticated with HTTP Basic credentials, paginated, filterable with double-underscore
  operators, and rate-limited with Retry-After.'
url: https://raw.githubusercontent.com/api-evangelist/cratejoy/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- crv
- y-combinator
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-18'
tags:
- Company
- Ecommerce
- Subscriptions
- Subscription Boxes
- Marketplace
- Payments
- Orders
- Webhooks
- REST
apis:
- name: Cratejoy Merchant API
  description: 'REST interface into most of the data and functionality of interest to Cratejoy merchants and developers: customers,
    orders, subscriptions, shipments, products, inventory, carts, transactions, addresses, stores, and webhooks. JSON throughout,
    HTTP Basic auth, page-number pagination, double-underscore filtering, 429 Retry-After.'
  humanURL: https://docs.cratejoy.com/reference/introduction-1
  baseURL: https://api.cratejoy.com/v1/
  properties:
  - type: Documentation
    url: https://docs.cratejoy.com/reference/introduction-1
  - type: APIReference
    url: https://docs.cratejoy.com/reference/authorization
  - type: Authentication
    url: authentication/cratejoy-authentication.yml
  - type: Conventions
    url: conventions/cratejoy-conventions.yml
  - type: ErrorCatalog
    url: errors/cratejoy-problem-types.yml
  - type: Webhooks
    url: asyncapi/cratejoy-webhooks.yml
  - type: DataModel
    url: data-model/cratejoy-data-model.yml
  - type: MCPServer
    url: mcp/cratejoy-mcp.yml
- name: Cratejoy Store API
  description: 'Front-end API that lets storefront JavaScript read (and sometimes write) data on behalf of the logged-in customer:
    customer, product, subscription, shipment, address, and survey methods, plus add-to-cart URLs.'
  humanURL: https://docs.cratejoy.com/reference/introduction
  baseURL: https://api.cratejoy.com/v1/
  properties:
  - type: Documentation
    url: https://docs.cratejoy.com/reference/introduction
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.cratejoy.com/
- type: DeveloperPortal
  url: https://docs.cratejoy.com/
- type: Documentation
  url: https://docs.cratejoy.com/
- type: APIReference
  url: https://docs.cratejoy.com/reference/introduction-1
- type: GettingStarted
  url: https://docs.cratejoy.com/reference/quick-start-add-a-tracking-number-to-a-shipment
- type: Support
  url: https://www.cratejoy.com/pages/contact
- type: Blog
  url: https://www.cratejoy.com/blogs/box-insider
- type: GitHubOrganization
  url: https://github.com/cratejoy
- type: Pricing
  url: https://sell.cratejoy.com/pricing
- type: SignUp
  url: https://sell.cratejoy.com/
- type: TermsOfService
  url: https://www.cratejoy.com/pages/terms
- type: PrivacyPolicy
  url: https://www.cratejoy.com/pages/privacy
- type: StatusPage
  url: https://status.cratejoy.com
- type: LLMsTxt
  url: llms/cratejoy-llms.txt
- type: Authentication
  url: authentication/cratejoy-authentication.yml
- type: Conventions
  url: conventions/cratejoy-conventions.yml
- type: ErrorCatalog
  url: errors/cratejoy-problem-types.yml
- type: Webhooks
  url: asyncapi/cratejoy-webhooks.yml
- type: Lifecycle
  url: lifecycle/cratejoy-lifecycle.yml
- type: Packages
  url: packages/cratejoy-packages.yml
- type: MCPServer
  url: mcp/cratejoy-mcp.yml
- type: Conformance
  url: conformance/cratejoy-conformance.yml
- type: DataModel
  url: data-model/cratejoy-data-model.yml
- type: DomainSecurity
  url: security/cratejoy-domain-security.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence