---
title: "POST /tenancies/{tenancyId}/charges"
method: POST
path: "/tenancies/{tenancyId}/charges"
tags: ["Charges"]
---

# POST /tenancies/{tenancyId}/charges

`POST /tenancies/{tenancyId}/charges`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/tenancies/{tenancyId}/charges`
- Auth: `appAuth` (a scheme the document does not define)

## Path parameters

- `tenancyId` string, required

## Headers

- `AgencyRef` string, required

## Request body `multipart/form-data`

- object
  - `tenantId` string: The unique identifier for the tenant.
  - `excludeFromArrears` boolean: Excludes the tenancy from arrears. If this is true then Alto.PropertyManagement.Api.Models.Requests.TenancyChargeRequest.ShowInArrearsAfterDays cannot be set. Defaults to false.
  - `showInArrearsAfterDays` integer: The tenancy will only show in arrears after so many days. Can only receive a positive value if Alto.PropertyManagement.Api.Models.Requests.TenancyChargeRequest.ExcludeFromArrears is false or null. Defaults to 0.
  - `sendDocs` boolean: Should the docs be sent. Defaults to false.
  - `paymentMethod` 'Unknown' | 'Bacs' | 'Cheque' | 'Cash' | 'StandingOrder' | 'DirectDebit' | 'Internet' | 'CreditCard' | 'DebitCard' | 'Transfer' | 'Journal' | 'ReceiptImport': Payment method.
  - `paymentReference` string: The payment reference.
  - `raiseInAdvanceDays` integer: Raise the payment in advance by this many days. Defaults to 0.
  - `raiseEndDate` string, date-time: Raise the charge up to and including this date.
  - `chargeType` 'Maintenance' | 'Deposit' | 'DepositToLandlord' | 'ReferencingFee' | 'AdministrationFee' | 'CheckInFee' | 'CheckOutFee' | 'TenancyAgreementFee' | 'CapitalExpenditure' | 'Cleaning' | 'Electrical' | 'Gardening' | 'Plumbing' | 'GasSafetyCheck' | 'EPC' | 'MaintenanceExpense' | 'InsuranceBuildings' | 'InsuranceContents' | 'InsuranceRentProtection' | 'UtilitiesWater' | 'UtilitiesCouncilTax' | 'UtilitiesElectricity' | 'UtilitiesGas' | 'Decorating' | 'BankCharges' | 'ServiceCharge' | 'GroundRent' | 'ElectricalSafetyCheck' | 'Appliances' | 'KeysLocksmith' | 'Inventory' | 'Furniture' | 'PortableApplianceTest' | 'LeadTest', required
  - `supplierId` string
  - `invoiceReference` string
  - `totalNet` number, float
  - `totalVat` number, float
  - `vatRateType` 'Exempt' | 'Standard' | 'Reduced' | 'Zero' | 'StandardROI'
  - `workOrderId` string
  - `invoiceDocument` string, binary
  - `description` string
  - `raiseImmediately` boolean
  - `chargeDate` string, date-time

## Response `201`

Created

- AltoPropertyManagementApiModelsResponsesTenancyCharge
  - `id` string, nullable
  - `supplierId` string, nullable
  - `chargeType` 'Maintenance' | 'Deposit' | 'DepositToLandlord' | 'ReferencingFee' | 'AdministrationFee' | 'CheckInFee' | 'CheckOutFee' | 'TenancyAgreementFee' | 'CapitalExpenditure' | 'Cleaning' | 'Electrical' | 'Gardening' | 'Plumbing' | 'GasSafetyCheck' | 'EPC' | 'MaintenanceExpense' | 'InsuranceBuildings' | 'InsuranceContents' | 'InsuranceRentProtection' | 'UtilitiesWater' | 'UtilitiesCouncilTax' | 'UtilitiesElectricity' | 'UtilitiesGas' | 'Decorating' | 'BankCharges' | 'ServiceCharge' | 'GroundRent' | 'ElectricalSafetyCheck' | 'Appliances' | 'KeysLocksmith' | 'Inventory' | 'Furniture' | 'PortableApplianceTest' | 'LeadTest'
  - `totalNet` number, float
  - `totalVat` number, float
  - `vatRateType` 'Exempt' | 'Standard' | 'Reduced' | 'Zero' | 'StandardROI'
  - `invoiceReference` string, nullable
  - `invoiceDocumentId` string, nullable
  - `workOrderId` string, nullable
  - `description` string, nullable
  - `chargeDate` string, date-time
  - `tenantId` string, nullable
  - `tenancyId` string, nullable
  - `propertyId` string, nullable
  - `excludeFromArrears` boolean
  - `showInArrearsAfterDays` integer
  - `sendDocs` boolean
  - `paymentMethod` 'Unknown' | 'Bacs' | 'Cheque' | 'Cash' | 'StandingOrder' | 'DirectDebit' | 'Internet' | 'CreditCard' | 'DebitCard' | 'Transfer' | 'Journal' | 'ReceiptImport', nullable
  - `paymentReference` string, nullable
  - `raiseInAdvanceDays` integer
  - `raiseEndDate` string, date-time, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)