# BillableItem Create/update billable item(s) Endpoint: POST /rest/api/standard/v1/BillableItem Version: 1.0.0 Security: basicAuth ## Request fields (application/json): - `billableItemList` (array) - `billableItemList.billableItemGuid` (string) Unique identifier and is automatically generated by Aimsio system. This is only used to update existing object - `billableItemList.billableItemCode` (string, required) Unique identifier, visible to end users. Required for creating or updating an object - `billableItemList.billableItemName` (string, required) - `billableItemList.billableItemTypeUname` (string) Required when creating a new object. Either or is required Enum: "labour", "equipment", "material", "service", "unit_billing", "per_diem", "accommodation", "mileage", "surcharge" - `billableItemList.billableItemTypeName` (string, required) Required when creating a new object. Either or is required - `billableItemList.billableItemIsTrade` (boolean, required) Set this to true if = 'Labour' - `billableItemList.billableItemIsEquipment` (boolean, required) Set this to true if = 'Equipment' - `billableItemList.billableItemCategory` (string) - `billableItemList.billableItemDescription` (string) - `billableItemList.billableItemStatus` (string) - `billableItemList.billableItemDefaultRate` (number, required) - `billableItemList.billableItemDefaultRateType` (string, required) Either or is required' - `billableItemList.billableItemDefaultRateTypeUname` (string) Either or is required' - `billableItemList.billableItemDefaultRate2` (number) - `billableItemList.billableItemDefaultRateType2` (string) If is provided, either or is required - `billableItemList.billableItemDefaultRateTypeUname2` (string) If is provided, either or is required - `billableItemList.billableItemDefaultRate3` (number) - `billableItemList.billableItemDefaultRateType3` (string) If is provided, either or is required - `billableItemList.billableItemDefaultRateTypeUname3` (string) If is provided, either or is required - `billableItemList.billableItemDefaultCost` (number) Cost Rates are only available for certain customer tiers - `billableItemList.billableItemDefaultCost2` (number) Cost Rates are only available for certain customer tiers - `billableItemList.billableItemDefaultCost3` (number) Cost Rates are only available for certain customer tiers - `billableItemList.billableItemGlAccountNumber` (string) Applicable to accounts with GL Account master data enabled. Must be an existing GL Account number - `billableItemList.billableItemUpdatedAt` (integer) Timestamp in epoch millseconds - `billableItemList.billableItemFormData` (object) Read-only schema used in GET requests to display object's custom fields data. For POST requests, refer to - `billableItemList.customFieldDataList` (array) - `billableItemList.customFieldDataList.customFieldDataDtype` (string) Enum: "NumberFieldData", "FreeTextFieldData", "Integer64FieldData", "LookupFieldData", "SelectFieldData", "BooleanFieldData", "TableFieldData" - `billableItemList.customFieldDataList.customFieldDataUname` (string) Unique identifier/key for the custom field - `billableItemList.customFieldDataList.customFieldDataStringValue` (string) Required if is not - `billableItemList.customFieldDataList.customFieldDataBooleanValue` (boolean) Required if is ## Response 200 fields (application/json): - `dtype` (string) - `id` (integer) - `guid` (string) - `importConfiguration` (string) - `numberOfEntitiesCreated` (integer) - `numberOfEntitiesEdited` (integer) - `numberOfEntitiesEditedWithErrors` (integer) - `numberOfEntitiesNotImportedDueToErrors` (integer) - `extra` (string) - `notices` (array) - `updatedAt` (integer) - `importResultType` (string) - `numberOfEntitiesImported` (integer)