---
title: "customer"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Sherpo merchant API

## Operations

- [Reads the store's customer stats over a period.](/merchant-api/reference/customer-stats/)
- [Pages the grants of access to customers.](/merchant-api/reference/list-grants/)
- [Grants a customer access to a product or tier.](/merchant-api/reference/grant-access/)
- [Revokes a grant of access.](/merchant-api/reference/revoke-grant/)
- [Pages customers' private feeds of blogs, podcasts and events, with the readers each served lately and its limit.](/merchant-api/reference/list-feeds/)
- [Pages customers' private feeds of blogs, podcasts and events, with the readers each served lately and its limit.](/merchant-api/reference/list-product-feeds/)
- [Sets how many readers a customer's private feed serves in 30 days before it moves to a new URL.](/merchant-api/reference/update-feed/)
- [Stops a customer's private feed of a blog, a podcast or an event.](/merchant-api/reference/revoke-feed/)
- [Lets a customer hold a private feed of a blog, a podcast or an event again after repeated sharing turned it off, counting sharing afresh.](/merchant-api/reference/unblock-feed/)
- [Pages a software product's licenses, their keys shortened to their last characters.](/merchant-api/reference/list-licenses/)
- [Records a key a customer holds from another platform as their license to a software product, so software in the field keeps checking; it may land disabled, or take the place of the customer's license.](/merchant-api/reference/record-license/)
- [Gets a license with its key, its status and the subscription behind it.](/merchant-api/reference/get-license/)
- [Sets a license's activation limit, its uses or its metadata.](/merchant-api/reference/update-license/)
- [Stops a license from checking as valid, whatever its holder's access.](/merchant-api/reference/disable-license/)
- [Lets a disabled license check as its holder's access says again.](/merchant-api/reference/enable-license/)
- [Reads a software product's license activity over a period: licenses issued and imported, verifies and uses, active licenses a day, and devices activated, freed and refused at the limit.](/merchant-api/reference/license-stats/)
- [Pages the devices a license counts, latest activated first, with those freed or gone inactive, never their instance ids.](/merchant-api/reference/list-license-activations/)
- [Frees one of a license's devices, so it stops counting toward the activation limit, whatever the license's status.](/merchant-api/reference/deactivate-license-activation/)
- [Gives a license a fresh key and emails it to the holder; the old key stops checking at once.](/merchant-api/reference/rotate-license/)
- [Checks a software product's license key from the seller's server: its status, why it is not active, when it ends, its tier and features, its uses, its devices and the subscription behind it; with \`count_use\` an active one counts a use, and with \`instance\` it reads and stamps that device. An unknown key, or another product's, answers \`not_found\`.](/merchant-api/reference/verify-license/)
- [Counts a device toward a software product's license from the seller's server, or refreshes one it already counts, and answers a signed token the software checks offline; past the license's activation limit (10,000 when nothing limits it) it answers \`conflict\` on \`items\`, and a license that is not active \`conflict\` on \`status\`.](/merchant-api/reference/activate-license/)
- [Answers a fresh signed token for a device a software product's active license counts, from the seller's server, stamping the device seen; a license that is not active answers \`conflict\` on \`status\`, and a device it does not count (never activated, freed or gone inactive) \`not_found\`.](/merchant-api/reference/refresh-license-token/)
- [Frees a device of a software product's license from the seller's server, whatever the license's status, an inactive one too; a device never activated, or already freed, answers \`not_found\`.](/merchant-api/reference/deactivate-license/)
- [Lists the store's published Ed25519 keys as JSON Web Keys, which software checks offline license tokens against: the one that signs, the next one, and those rotated out while a token they signed may live.](/merchant-api/reference/list-license-signing-keys/)
- [Promotes the store's next license signing key to sign new tokens and publishes a fresh next one, keeping the old key published for 365 days; with \`retire_previous\` every key that no longer signs leaves the published set at once, though software that embeds it trusts it until updated. With \`current\`, a rotation since answers \`conflict\`. A store with no keys gets its first set.](/merchant-api/reference/rotate-license-signing-keys/)
- [Pages what customers may reach, as their grants and subscriptions add up.](/merchant-api/reference/list-entitlements/)
- [Pages the store's customers.](/merchant-api/reference/list-customers/)
- [Pages customers' activity over a period.](/merchant-api/reference/list-customer-activity/)
- [Pages a product's customers.](/merchant-api/reference/list-product-customers/)
- [Counts a product's customers by status.](/merchant-api/reference/product-customer-stats/)
- [Pages the store's checkouts.](/merchant-api/reference/list-checkouts/)
- [Reads one customer.](/merchant-api/reference/get-customer/)
- [Erases a customer's personal data, keeping the records of what they bought.](/merchant-api/reference/erase-customer/)
- [Pages an event's guest list: one row per person, going or canceled, with their tier and how they got their ticket.](/merchant-api/reference/list-event-attendees/)
- [Counts an event's attendees: going, canceled by reason, going by tier, and the spots its capacity leaves.](/merchant-api/reference/event-attendee-stats/)
- [Reads a customer's answers to each product's registration questions, latest answered first.](/merchant-api/reference/list-customer-answers/)
- [Answers a product's registration questions for a customer who holds it, such as answers they gave elsewhere.](/merchant-api/reference/set-customer-answers/)
- [Pages a product's requests: buyers waiting for approval, an event's waitlist, and those decided.](/merchant-api/reference/list-product-requests/)
- [Approves a pending request: the buyer is granted what they asked for, on the seats their order holds.](/merchant-api/reference/approve-product-request/)
- [Declines a pending request or a waitlist place, giving back any seats it holds.](/merchant-api/reference/decline-product-request/)
- [Lets a waitlisted buyer in once the event has their seats: a free order takes them and the buyer is granted at once.](/merchant-api/reference/promote-product-request/)


Source: https://docs.sherpo.io/merchant-api/reference/tags/customer/index.md
