The plan objects allow you to create one-off or recurring named charges.
You can retrieve individual plans as well as a list of all your plans.
Here is the list of the plan object properties:
Plan
Property | Type | Required | Description |
---|---|---|---|
name | string | true | The name of the plan in hand. It appears everywhere in the system. |
description | string | false | Text describing the plan. It will appear when users need to choose among different plans. |
price | number | true | The default unit price for the plan, depending if it is recurring plan or a one-off plan. |
locations | Location | true | List of all locations where the plan is present. If empty, all locations are assumed. |
type | enum | true | The type of the plan. It could be office, desk, hotdesk or service. |
intervalLength | enum | true | The plan interval. It could be month or once. |
code | string | false | External identifier for the plan. Usually used for accounting purposes. |
createdAt | date | readonly | The date when the plan has been created. |
createdBy | id | readonly | The user that created the plan. |
modifiedAt | date | readonly | The user that did the last modification to the plan. If no update is made this field will match the createdBy field. |
modifiedBy | id | readonly | The user that did the last modification to the plan. Before the first modification, this field equals to the createdBy field. |
Note
Right now the plans API returns both rates and plans, so you should ignore all items with isRate property set to true*