Billing Accounts

Endpointhttps://app.monad.com/api

Download schema

Billing account management

List Billing Accounts

GET

https://app.monad.com/api

/v2/billing/accounts

Authorization (header)

List Billing Accounts

List Billing Accounts › query Parameters

limit

integer

Limit

offset

integer

Offset

List Billing Accounts › Responses

list billing accounts successfull

object[]

object

GET/v2/billing/accounts

curl --request GET \
  --url https://app.monad.com/api/v2/billing/accounts

shell

Example Responses

{
  "billing_accounts": [
    {
      "billing_email": "billing_email",
      "created_at": "created_at",
      "current_billing_cycle_end": "current_billing_cycle_end",
      "current_billing_cycle_start": "current_billing_cycle_start",
      "deleted_at": "deleted_at",
      "description": "description",
      "has_payment_method": true,
      "id": "id",
      "name": "name",
      "next_product": {
        "contact_email": "contact_email",
        "created_at": "created_at",
        "description": "description",
        "features": [
          "string"
        ],
        "id": "id",
        "is_default": true,
        "name": "name",
        "product_type": "default",
        "recurring_cost_cents": 0,
        "recurring_frequency": "recurring_frequency",
        "slug": "slug",
        "updated_at": "updated_at",
        "usage_unit": "usage_unit",
        "usage_unit_cost_cents": 0
      },
      "next_product_id": "next_product_id",
      "product": {
        "contact_email": "contact_email",
        "created_at": "created_at",
        "description": "description",
        "features": [
          "string"
        ],
        "id": "id",
        "is_default": true,
        "name": "name",
        "product_type": "default",
        "recurring_cost_cents": 0,
        "recurring_frequency": "recurring_frequency",
        "slug": "slug",
        "updated_at": "updated_at",
        "usage_unit": "usage_unit",
        "usage_unit_cost_cents": 0
      },
      "product_change_after": "product_change_after",
      "product_id": "product_id",
      "status": "status",
      "suspend_on": "suspend_on",
      "updated_at": "updated_at"
    }
  ],
  "pagination": {
    "limit": 0,
    "offset": 0,
    "total": 0
  }
}

json

application/json

Create Billing Account

POST

https://app.monad.com/api

/v2/billing/accounts

Authorization (header)

Create Billing Account

Create Billing Account › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: billing_email, name

Properties for Variant 1:

Create Billing Account › Responses

billing account created successfully

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string

POST/v2/billing/accounts

curl --request POST \
  --url https://app.monad.com/api/v2/billing/accounts \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

Example Responses

{
  "billing_email": "billing_email",
  "created_at": "created_at",
  "current_billing_cycle_end": "current_billing_cycle_end",
  "current_billing_cycle_start": "current_billing_cycle_start",
  "deleted_at": "deleted_at",
  "description": "description",
  "has_payment_method": true,
  "id": "id",
  "name": "name",
  "next_product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "next_product_id": "next_product_id",
  "product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "product_change_after": "product_change_after",
  "product_id": "product_id",
  "status": "status",
  "suspend_on": "suspend_on",
  "updated_at": "updated_at"
}

json

application/json

Get Billing Account

GET

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Get Billing Account

Get Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Get Billing Account › Responses

get billing account successfull

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string

GET/v2/billing/accounts/{billing_account_id}

curl --request GET \
  --url https://app.monad.com/api/v2/billing/accounts/:billing_account_id

shell

Example Responses

{
  "billing_email": "billing_email",
  "created_at": "created_at",
  "current_billing_cycle_end": "current_billing_cycle_end",
  "current_billing_cycle_start": "current_billing_cycle_start",
  "deleted_at": "deleted_at",
  "description": "description",
  "has_payment_method": true,
  "id": "id",
  "name": "name",
  "next_product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "next_product_id": "next_product_id",
  "product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "product_change_after": "product_change_after",
  "product_id": "product_id",
  "status": "status",
  "suspend_on": "suspend_on",
  "updated_at": "updated_at"
}

json

application/json

Delete Billing Account

DELETE

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Delete Billing Account

Delete Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Delete Billing Account › Responses

Billing account deleted successfully

No data returned

Update Billing Account

PATCH

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Update Billing Account

Update Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Update Billing Account › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

Update Billing Account › Responses

billing account updated successfully

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string

PATCH/v2/billing/accounts/{billing_account_id}

curl --request PATCH \
  --url https://app.monad.com/api/v2/billing/accounts/:billing_account_id \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

Example Responses

{
  "billing_email": "billing_email",
  "created_at": "created_at",
  "current_billing_cycle_end": "current_billing_cycle_end",
  "current_billing_cycle_start": "current_billing_cycle_start",
  "deleted_at": "deleted_at",
  "description": "description",
  "has_payment_method": true,
  "id": "id",
  "name": "name",
  "next_product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "next_product_id": "next_product_id",
  "product": {
    "contact_email": "contact_email",
    "created_at": "created_at",
    "description": "description",
    "features": [
      "string"
    ],
    "id": "id",
    "is_default": true,
    "name": "name",
    "product_type": "default",
    "recurring_cost_cents": 0,
    "recurring_frequency": "recurring_frequency",
    "slug": "slug",
    "updated_at": "updated_at",
    "usage_unit": "usage_unit",
    "usage_unit_cost_cents": 0
  },
  "product_change_after": "product_change_after",
  "product_id": "product_id",
  "status": "status",
  "suspend_on": "suspend_on",
  "updated_at": "updated_at"
}

json

application/json

Organizations Metrics Billing Accounts RBAC

Create Billing Account

POST

https://app.monad.com/api

/v2/billing/accounts

Authorization (header)

Create Billing Account

Create Billing Account › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: billing_email, name

Properties for Variant 1:

Create Billing Account › Responses

billing account created successfully

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string

Get Billing Account

GET

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Get Billing Account

Get Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Get Billing Account › Responses

get billing account successfull

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string

Delete Billing Account

DELETE

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Delete Billing Account

Delete Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Delete Billing Account › Responses

Billing account deleted successfully

No data returned

Update Billing Account

PATCH

https://app.monad.com/api

/v2/billing/accounts/{billing_account_id}

Authorization (header)

Update Billing Account

Update Billing Account › path Parameters

billing_account_id

string · required

Billing Account ID

Update Billing Account › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

Update Billing Account › Responses

billing account updated successfully

billing_email

string

created_at

string

current_billing_cycle_end

string

current_billing_cycle_start

string

deleted_at

string

description

string

has_payment_method

boolean

id

string

name

string

object

next_product_id

string

object

product_change_after

string

product_id

string

status

string

suspend_on

string

updated_at

string