Custom store API / Capabilities

Declare features (capabilities)

Tell Lillo which features your store supports. [Test connection] calls this endpoint, and Lillo shows agents and automations only the features you turn on here.

GET/v1/capabilities

Request

curl "https://api.mall.example.com/v1/capabilities" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"

Response — 200 OK

{
  "data": {
    "api_version": "2026-11-01",
    "spec_version": "1.1",
    "orders": true,
    "shipments_endpoint": false,
    "members": true,
    "products": true,
    "claims": ["cancel", "return", "exchange"],
    "receiver_update": true,
    "memos": true,
    "coupons": true,
    "coupon_issue": true,
    "categories": true,
    "catalog": true,
    "pagination": "cursor",
    "webhooks": []
  }
}

Response fields

api_versionstringRequired

2026-11-01

spec_versionstringOptional

The spec version you implement. "1.1" if you turn on v1.1 features

ordersbooleanRequired

Order lookup. Always true

shipments_endpointbooleanOptional

Whether the shipments endpoint is available

membersbooleanOptional

Get a member

productsbooleanOptional

Product search and detail

claimsstring[]Optional

v1.1 request types — whichever of cancel, return and exchange you support

receiver_updatebooleanOptional

v1.1 shipping address change

memosbooleanOptional

v1.1 order memos

couponsbooleanOptional

v1.1 coupon list and member's coupons

coupon_issuebooleanOptional

v1.1 coupon issuing

categoriesbooleanOptional

v1.1 category list

catalogbooleanOptional

v1.1 full catalog list (syncs the knowledge “Products” folder)

paginationstringOptional

"cursor" (default) or "offset" (Cafe24-compatible)

webhooksstring[]Optional

Coming soon. Use [] for now

FieldTypeRequiredDescription

api_versionstringRequired2026-11-01

spec_versionstringOptionalThe spec version you implement. "1.1" if you turn on v1.1 features

ordersbooleanRequiredOrder lookup. Always true

shipments_endpointbooleanOptionalWhether the shipments endpoint is available

membersbooleanOptionalGet a member

productsbooleanOptionalProduct search and detail

claimsstring[]Optionalv1.1 request types — whichever of cancel, return and exchange you support

receiver_updatebooleanOptionalv1.1 shipping address change

memosbooleanOptionalv1.1 order memos

couponsbooleanOptionalv1.1 coupon list and member's coupons

coupon_issuebooleanOptionalv1.1 coupon issuing

categoriesbooleanOptionalv1.1 category list

catalogbooleanOptionalv1.1 full catalog list (syncs the knowledge “Products” folder)

paginationstringOptional"cursor" (default) or "offset" (Cafe24-compatible)

webhooksstring[]OptionalComing soon. Use [] for now

How it works

Missing keys are treated as unsupported (false).
If this endpoint returns 404, Lillo assumes order lookup only and still treats the connection as successful.
If you turn a feature on but its endpoint returns 404, Lillo fails that feature as “not supported by the store” and shows it to your team.
If you change features, click [Test connection] in the console again. That's when Lillo re-reads capabilities.

PreviousOverview NextOrder lookup