List currencies
List currencies supported by the billing system.
Query Parameters
Determines which page of the collection to retrieve.
Show Child Parameters
Filter options for listing currencies.
Show Child Parameters
Response
application/json
Response
Page paginated response.
CurrencyPagePaginatedResponse
Page paginated response.
One OfFiat or custom currency.
Currency describes a currency supported by the billing system.
Show Child Parameters
returns the pagination information
Show Child Parameters
Authentication
Query Parameters
Create custom currency
Create a custom currency.
This operation allows defining your own custom currency for billing purposes.
Body
application/json
Body
CreateCurrencyCustomRequest
CurrencyCustom create request.
The name of the currency. It should be a human-readable string that represents the name of the currency, such as “US Dollar” or “Euro”.
>= 1 characters<= 256 characters
Description of the currency.
>= 1 characters<= 256 characters
The symbol of the currency. It should be a string that represents the symbol of the currency, such as “$” for US Dollar or “€” for Euro.
>= 1 characters
Custom currency code.
It should be a unique code but not conflicting with any existing fiat currency codes.
>= 3 characters<= 24 characters
Response
application/json
Response
CurrencyCustom created response.
BillingCurrencyCustom
Describes custom currency.
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
The type of the currency.
Allowed values:custom
The name of the currency. It should be a human-readable string that represents the name of the currency, such as “US Dollar” or “Euro”.
>= 1 characters<= 256 characters
Description of the currency.
>= 1 characters<= 256 characters
The symbol of the currency. It should be a string that represents the symbol of the currency, such as “$” for US Dollar or “€” for Euro.
>= 1 characters
Custom currency code.
It should be a unique code but not conflicting with any existing fiat currency codes.
>= 3 characters<= 24 characters
An ISO-8601 timestamp representation of the custom currency creation date.
Example:2023-01-01T01:01:01.001Z
Authentication
Body
List cost bases
List cost bases for a currency.
For custom currencies, there can be multiple cost bases with different effective_from dates.
Query Parameters
Filter options for listing cost bases.
Show Child Parameters
Determines which page of the collection to retrieve.
Show Child Parameters
Path Parameters
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Response
application/json
Response
Page paginated response.
CostBasisPagePaginatedResponse
Page paginated response.
Describes currency basis supported by billing system.
Show Child Parameters
returns the pagination information
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Create cost basis
Create a cost basis for a currency.
Path Parameters
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
Body
application/json
Body
CreateCostBasisRequest
CostBasis create request.
The fiat currency code for the cost basis.
Match pattern:^[A-Z]{3}$
>= 3 characters<= 3 characters
Example:USD
The cost rate for the currency.
Match pattern:^\-?[0-9]+(\.[0-9]+)?$
An ISO-8601 timestamp representation of the date from which the cost basis is effective.
If not provided, it will be effective immediately and will set to now by the system.
Example:2023-01-01T01:01:01.001Z
Response
application/json
Response
CostBasis created response.
BillingCostBasis
Describes currency basis supported by billing system.
ULID (Universally Unique Lexicographically Sortable Identifier).
Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:01G65Z755AFWAKHE12NY0CQ9FH
The fiat currency code for the cost basis.
Match pattern:^[A-Z]{3}$
>= 3 characters<= 3 characters
Example:USD
The cost rate for the currency.
Match pattern:^\-?[0-9]+(\.[0-9]+)?$
An ISO-8601 timestamp representation of the date from which the cost basis is effective.
If not provided, it will be effective immediately and will set to now by the system.
Example:2023-01-01T01:01:01.001Z
An ISO-8601 timestamp representation of entity creation date.
Example:2023-01-01T01:01:01.001Z
Authentication
Path Parameters
Body
Meters
Meters specify how to aggregate events for billing and analytics purposes. Meters can be configured with multiple aggregation methods and groupings. Multiple meters can be created for the same event type, enabling flexible metering scenarios.