Get app
Get an installed app.
Path Parameters
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Response
application/json
Response
App response.
BillingApp
Installed application.
One OfULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Display name of the resource.
Between 1 and 256 characters.
>= 1 characters<= 256 characters
Optional description of the resource.
Maximum 1024 characters.
<= 1024 characters
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
An ISO-8601 timestamp representation of entity creation date.
Example:2023-01-01T01:01:01.001Z
An ISO-8601 timestamp representation of entity last update date.
Example:2023-01-01T01:01:01.001Z
An ISO-8601 timestamp representation of entity deletion date.
Example:2023-01-01T01:01:01.001Z
The app type.
Allowed values:stripe
The app catalog definition that this installed app is based on.
Example:{"type":"stripe","name":"Stripe","description":"Stripe integration allows you to collect payments with Stripe."}
Show Child Parameters
Status of the app connection.
Allowed values:readyunauthorized
The Stripe account ID associated with the connected Stripe account.
Indicates whether the app is connected to a live Stripe account.
The masked Stripe API key that only exposes the first and last few characters.
Authentication
Path Parameters
OpenMeter Entitlements
Entitlements are used to control access to features for customers.
List customer entitlement access
Path Parameters
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Response
application/json
Response
List the customer’s active features and their access.
ListCustomerEntitlementAccessResponseData
List customer entitlement access response data.
Entitlement access result.
Show Child Parameters
Authentication
Path Parameters
OpenMeter Subscriptions
Subscriptions are used to track usage of your product or service. Subscriptions can be individuals or organizations that can subscribe to plans and have access to features.
Create subscription
Body
application/json
Body
BillingSubscriptionCreate
Subscription create request.
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
The customer to create the subscription for.
Show Child Parameters
The plan reference of the subscription.
Show Child Parameters
A billing anchor is the fixed point in time that determines the subscription’s recurring billing cycle.
It affects when charges occur and how prorations are calculated.
Common anchors:
- Calendar month (1st of each month):
2025-01-01T00:00:00Z - Subscription anniversary (day customer signed up)
- Custom date (customer-specified day)
If not provided, the subscription will be created with the subscription’s creation time as the billing anchor.
Example:2023-01-01T01:01:01.001Z
Response
application/json
Response
Subscription created response.
BillingSubscription
Subscription.
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"env":"test"}
An ISO-8601 timestamp representation of entity creation date.
Example:2023-01-01T01:01:01.001Z
An ISO-8601 timestamp representation of entity last update date.
Example:2023-01-01T01:01:01.001Z
An ISO-8601 timestamp representation of entity deletion date.
Example:2023-01-01T01:01:01.001Z
The customer ID of the subscription.
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
The plan ID of the subscription.
Set if subscription is created from a plan.
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
A billing anchor is the fixed point in time that determines the subscription’s recurring billing cycle.
It affects when charges occur and how prorations are calculated.
Common anchors:
- Calendar month (1st of each month):
2025-01-01T00:00:00Z - Subscription anniversary (day customer signed up)
- Custom date (customer-specified day)
Example:2023-01-01T01:01:01.001Z
The status of the subscription.
Allowed values:activeinactivecanceledscheduled