0.0.1OAS 3.0

Konnect Metering & Billing API.

API Base URL
  • Server 1:https://us.api.konghq.com/v3

    United-States Production region

  • Server 2:https://eu.api.konghq.com/v3

    Europe Production region

  • Server 3:https://au.api.konghq.com/v3

    Australia Production region

  • Server 4:https://me.api.konghq.com/v3

    Middle-East Production region

  • Server 5:https://in.api.konghq.com/v3

    India Production region

  • Server 6:https://sg.api.konghq.com/v3

    Singapore Production region

Security
systemAccountAccessToken (http)

The system account access token is meant for automations and integrations that are not directly associated with a human identity.
You can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.
The access token must be passed in the header of a request, for example:
curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'

personalAccessToken (http)

The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.
You can generate a Personal Access Token (PAT) from the personal access token page in the Konnect dashboard.
The PAT token must be passed in the header of a request, for example:
curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'

konnectAccessToken (http)

The Konnect access token is meant to be used by the Konnect dashboard and the decK CLI authenticate with.

Additional Information
Contact Kong

OpenMeter Billing

Billing manages the billing profiles, currencies, cost bases, and invoices for customers.

List billing profiles

List billing profiles.

get

Query Parameters

pageobject

Determines which page of the collection to retrieve.

Show Child Parameters

Response

application/json

Page paginated response.

BillingProfilePagePaginatedResponse

Page paginated response.

dataarray[object]required

Billing profiles contain the settings for billing and controls invoice generation.

Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/openmeter/profiles
 
application/json

Create a new billing profile

Create a new billing profile.

Billing profiles contain the settings for billing and controls invoice generation.
An organization can have multiple billing profiles defined.
A billing profile is linked to a specific app. This association is established during the billing profile’s creation and remains immutable.

post

Body

application/json

CreateBillingProfileRequest

BillingProfile create request.

namestringrequired

Display name of the resource.

Between 1 and 256 characters.

>= 1 characters<= 256 characters

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

<= 1024 characters

labelsobject

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"}

supplierobjectrequired

The name and contact information for the supplier this billing profile represents

Show Child Parameters
workflowobjectrequired

The billing workflow settings for this profile

Show Child Parameters
appsobjectrequired

The applications used by this billing profile.

Show Child Parameters
defaultbooleanrequired

Whether this is the default profile.

Response

application/json

BillingProfile created response.

BillingProfile

Billing profiles contain the settings for billing and controls invoice generation.

idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

namestringrequired

Display name of the resource.

Between 1 and 256 characters.

>= 1 characters<= 256 characters

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

<= 1024 characters

labelsobject

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"}

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity creation date.

Example:2023-01-01T01:01:01.001Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity last update date.

Example:2023-01-01T01:01:01.001Z

deleted_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity deletion date.

Example:2023-01-01T01:01:01.001Z

supplierobjectrequired

The name and contact information for the supplier this billing profile represents

Show Child Parameters
workflowobjectrequired

The billing workflow settings for this profile

Show Child Parameters
appsobjectrequired

The applications used by this billing profile.

Show Child Parameters
defaultbooleanrequired

Whether this is the default profile.

post/openmeter/profiles

Body

{ "name": "name", "supplier": {}, "workflow": {}, "apps": { "tax": { "id": "01G65Z755AFWAKHE12NY0CQ9FH" }, "invoicing": { "id": "01G65Z755AFWAKHE12NY0CQ9FH" }, "payment": { "id": "01G65Z755AFWAKHE12NY0CQ9FH" } }, "default": false }
 
application/json

Get a billing profile

Get a billing profile.

get

Path Parameters

idstringrequired

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

Response

application/json

BillingProfile response.

BillingProfile

Billing profiles contain the settings for billing and controls invoice generation.

idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

namestringrequired

Display name of the resource.

Between 1 and 256 characters.

>= 1 characters<= 256 characters

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

<= 1024 characters

labelsobject

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"}

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity creation date.

Example:2023-01-01T01:01:01.001Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity last update date.

Example:2023-01-01T01:01:01.001Z

deleted_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity deletion date.

Example:2023-01-01T01:01:01.001Z

supplierobjectrequired

The name and contact information for the supplier this billing profile represents

Show Child Parameters
workflowobjectrequired

The billing workflow settings for this profile

Show Child Parameters
appsobjectrequired

The applications used by this billing profile.

Show Child Parameters
defaultbooleanrequired

Whether this is the default profile.

get/openmeter/profiles/{id}
 
application/json