Lemon Squeezy Usage Records API
The Usage Records API from Lemon Squeezy — 2 operation(s) for usage records.
The Usage Records API from Lemon Squeezy — 2 operation(s) for usage records.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/lemon-squeezy:lemon-squeezy-usage-records-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Lemon Squeezy Usage Records API
description: The Lemon Squeezy API is a REST API based on the JSON:API specification.
termsOfService: https://www.lemonsqueezy.com/terms
contact:
name: Lemon Squeezy Support
url: https://docs.lemonsqueezy.com
version: v1
servers:
- url: https://api.lemonsqueezy.com/v1
security:
- api_key: []
tags:
- name: Usage Records
paths:
/usage-records:
get:
operationId: listUsageRecords
tags:
- Usage Records
summary: List all usage records
parameters:
- name: filter[subscription_item_id]
in: query
schema:
type: string
responses:
'200':
description: A list of usage records.
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/JsonApiCollection'
post:
operationId: createUsageRecord
tags:
- Usage Records
summary: Create a usage record
description: Report usage for a usage-based subscription item.
requestBody:
required: true
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/JsonApiResource'
responses:
'201':
description: The created usage record object.
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/JsonApiResource'
/usage-records/{id}:
get:
operationId: retrieveUsageRecord
tags:
- Usage Records
summary: Retrieve a usage record
parameters:
- $ref: '#/components/parameters/ResourceId'
responses:
'200':
description: A usage record object.
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/JsonApiResource'
components:
parameters:
ResourceId:
name: id
in: path
required: true
description: The resource ID.
schema:
type: string
schemas:
JsonApiResource:
type: object
description: A JSON:API document containing a single resource object.
properties:
jsonapi:
type: object
properties:
version:
type: string
data:
$ref: '#/components/schemas/JsonApiResourceObject'
links:
type: object
additionalProperties:
type: string
JsonApiCollection:
type: object
description: A JSON:API document containing a collection of resource objects.
properties:
jsonapi:
type: object
properties:
version:
type: string
data:
type: array
items:
$ref: '#/components/schemas/JsonApiResourceObject'
links:
type: object
description: Pagination links (first, last, prev, next).
additionalProperties:
type: string
meta:
type: object
properties:
page:
type: object
properties:
currentPage:
type: integer
from:
type: integer
lastPage:
type: integer
perPage:
type: integer
to:
type: integer
total:
type: integer
JsonApiResourceObject:
type: object
description: A single JSON:API resource object.
properties:
type:
type: string
description: The resource type, e.g. stores, products, subscriptions.
id:
type: string
description: The unique resource ID.
attributes:
type: object
description: The resource's attributes.
additionalProperties: true
relationships:
type: object
description: Related resources.
additionalProperties: true
links:
type: object
additionalProperties:
type: string
securitySchemes:
api_key:
type: http
scheme: bearer
bearerFormat: apiKey
description: Bearer authentication using a Lemon Squeezy API key. Requests must also send Accept and Content-Type headers of application/vnd.api+json.