# Create improvement

**POST /api/v2/household/{HouseholdGUID}/assets/{AssetGUID}/improvements**

This endpoint allows users to create a new asset improvement.


## Servers
- https://api.fincalc.co.uk: https://api.fincalc.co.uk ()


## Authentication methods
- Bearer auth


## Parameters

#### Path parameters
- **HouseholdGUID** (string(uuid))
  The HouseholdGUID of the client.
- **AssetGUID** (string(uuid))
  The AssetGUID you want to create an improvement for.


## Body parameters
Content-type: application/json

- **TransactionType** (integer)
  Value must be set to 10.

- **Description** (string)
  
- **TransactionAmount** (number(float))
  
- **AssetIncrease** (number(float))
  
- **StartBasis** (integer)
  To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint:
/api/v2/household/{HouseholdGUID}/assets/improvements/options

- **StartEventGUID** (string(uuid) | null)
  This field is required if the value of StartBasis = 4.

To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint:
/api/v2/household/{HouseholdGUID}/assets/improvements/options

- **StartAge** (integer | null)
  This field is required if the value of StartBasis = 2 or 7.
StartAge must be in the future.

- **StartDate** (string | null)
  This field is required if the value of StartBasis = 3.
StartDate should be in the future.

Dates should be provided in the format "Y-m-d", where "Y" represents the year, "m" represents the month and "d" represents the day. For example, "2023-07-24" represents 24th July, 2023.

- **ExcludeFormattedValues** (string | null)
  If set to any value, formatted values will be excluded from the response.


## Responses
### 201: Success

#### Body Parameters: application/json (object)
- **success** (boolean)
  
- **data** (object)
  

### 403: Permission error.

#### Body Parameters: application/json (object)
- **success** (boolean)
  
- **message** (string)
  

### 404: Household not found

#### Body Parameters: application/json (object)
- **success** (boolean)
  
- **message** (string)
  

### 422: Validation error.

#### Body Parameters: application/json (object)
- **success** (boolean)
  
- **message** (string)
  
- **data** (object)
  Example validation error message.

### 500: Internal server error.

#### Body Parameters: application/json (object)
- **success** (boolean)
  
- **message** (string)
  


[Powered by Bump.sh](https://bump.sh)