Association violations

Create an association violation

Records a violation notice received from a homeowners association. Give it at least one of a lease, a unit or a property; whichever of the three you leave out is worked out from the one you supply.

POST

https://api.portal.magicdoor.com/company-app/associations/violations

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Body

application/json

hoaVendorIdstringrequired

The vendor record for the association that issued the notice. A Snowflake id sent as a decimal string.

propertyIdstring

The property the violation is against. Supply this, unitId or leaseId.

unitIdstring

The unit the violation is against. Supply this, propertyId or leaseId.

leaseIdstring

The lease the violation is against. Supply this, unitId or propertyId. A lease is what makes it possible to bill the tenant later.

statusenum<string>

Where to start the violation.

default: receivedreceivedinProgressresolved

referencestring

The association's own reference, up to 150 characters. A random reference is generated when this is left out.

violationReceivedDatestring · daterequired

The day the notice reached you. Read in the company's timezone.

violationDatestring · daterequired

The day the violation itself happened. Read in the company's timezone.

fixByDatestring · date

The deadline the association gave.

associationFinenumber

The fine the association charges, for example 250.00. Needed later if you want to charge the fine on.

titlestring

Short title, up to 150 characters. When this is left out MagicDoor writes one from the description using AI.

descriptionstringrequired

What the association says is wrong.

Response

200 · The violation that was created.

idstring

The violation. A Snowflake id sent as a decimal string.

portfolioIdstring

The portfolio the violation was raised against.

propertyIdstring

The property the violation was raised against.

unitIdstring

The unit the violation was raised against. Absent when the violation is property-wide.

leaseIdstring

The lease the violation was raised against. Absent when no lease is involved.

statusenum<string>

Where the violation sits in its workflow.

receivedinProgressresolved

hoaVendorIdstring

The vendor record for the homeowners association that issued the violation.

referencestring

The association's own reference for the violation. Generated automatically when the caller did not supply one.

violationReceivedDatestring · date

The day the association's notice reached the property manager.

violationDatestring · date

The day the violation itself happened.

fixByDatestring · date

The deadline the association gave for putting it right. Absent when no deadline was given.

associationFinenumber

The fine the association charges, for example 250.00. Absent when no fine was recorded.

titlestring

Short title. Written by an AI summary of the description when the caller did not supply one.

descriptionstring

What the association says is wrong.

notificationSentAtstring · date-time

When a notice was last sent to the lease or the owners, in the company's timezone. Absent while no notice has been sent.

filesobject[]

Files attached to the violation, such as the association's own notice.

propertyFineBillobject

The vendor bill raised against the property for the association's fine. Absent until the fine is charged.

leaseFineBillobject

The lease charge raised when the fine was passed on to the tenant. Absent when the fine was not passed on.

portfolioobject

The portfolio the violation belongs to.

propertyobject

The property the violation was raised against.

unitobject

The unit the violation was raised against. Absent when the violation is property-wide.

leaseobject

The lease the violation was raised against. Absent when no lease is involved.

workOrdersobject[]

Work orders raised from this violation.

leaseBillsobject[]

Extra lease charges added against this violation, beyond the fine itself.

ownersobject[]

Owners of the property, as used when sending an owner notice.

workOrderVendorsobject[]

Vendors assigned to the work orders above.

400 · None of `propertyId`, `unitId` or `leaseId` was supplied, or an id was not a valid Snowflake id.

401 · The access token is missing, expired, or not valid for this company.

curl --request POST \ --url 'https://api.portal.magicdoor.com/company-app/associations/violations' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "hoaVendorId": "1830472847398408008", "leaseId": "1830472847398404096", "violationReceivedDate": "2026-03-02", "violationDate": "2026-02-27", "fixByDate": "2026-03-20", "associationFine": 250, "title": "Trash bins left at curb", "description": "Bins were left at the curb for three days after collection." }'

{ "hoaVendorId": "1830472847398408008", "leaseId": "1830472847398404096", "violationReceivedDate": "2026-03-02", "violationDate": "2026-02-27", "fixByDate": "2026-03-20", "associationFine": 250, "title": "Trash bins left at curb", "description": "Bins were left at the curb for three days after collection." }

{ "id": "1830472847398407007", "portfolioId": "1830472847398401001", "propertyId": "1830472847398402002", "unitId": "1830472847398403003", "leaseId": "1830472847398404096", "status": "received", "hoaVendorId": "1830472847398408008", "reference": "K7QP2M", "violationReceivedDate": "2026-03-02", "violationDate": "2026-02-27", "fixByDate": "2026-03-20", "associationFine": 250, "title": "Trash bins left at curb", "description": "Bins were left at the curb for three days after collection.", "files": [ { "id": "1830472847398404200", "created": "2026-03-04T09:12:44", "name": "notice.pdf", "extension": "pdf", "size": 84213, "contentType": "application/pdf", "secureUrl": { "base": "https://files.example-host", "raw": "/files/1830472847398404200", "variantTemplate": "/files/1830472847398404200/{variant}" }, "fileId": "1830472847398404200", "fileName": "notice.pdf", "signedUrl": "https://files.example-host/files/1830472847398404200?signature=abc123", "fileSize": 84213, "uploaded": "2026-03-04T09:12:44", "claimed": true } ], "portfolio": { "id": "1830472847398401001", "active": true, "name": "Downtown", "propertyCount": 12, "icons": [] }, "property": { "id": "1830472847398402002", "name": "Pine Street Duplex", "displayName": "Pine Street Duplex", "address": { "streetAddress1": "412 W Pine St", "city": "Missoula", "state": "MT", "zipCode": "59802", "country": "US", "isValid": true }, "portfolioId": "1830472847398401001", "type": "multiFamily", "unitCount": 2, "recentRentalApplications": 0, "active": true, "icons": [] }, "unit": { "id": "1830472847398403003", "name": "A", "address": { "streetAddress1": "412 W Pine St", "city": "Missoula", "state": "MT", "zipCode": "59802", "country": "US", "isValid": true }, "beds": 2, "baths": 1, "unitSizeSqft": 880, "marketRent": 1850, "propertyId": "1830472847398402002", "portfolioId": "1830472847398401001", "active": true, "icons": [] }, "lease": { "id": "1830472847398404096", "portfolioId": "1830472847398401001", "propertyId": "1830472847398402002", "unitId": "1830472847398403003", "start": "2026-01-01", "end": "2026-12-31", "ended": false, "monthToMonth": false, "eviction": false, "chatId": "1830472847398405005", "tenants": [ { "tenantId": "1830472847398406006", "moveIn": "2026-01-01" } ], "balance": 1850, "currentRent": 1850, "securityDepositPaid": 1850, "securityDepositRequested": 1850, "securityDepositDue": 0, "lastPaymentDate": "2026-02-02", "earliestUnpaidBillDueDate": "2026-03-01", "icons": [], "draft": false, "status": "lease", "expiringStatus": "none", "pastDueDays": 3, "postedBalance": 1850 }, "workOrders": [], "leaseBills": [], "owners": [ { "id": "1830472847398413013", "active": true, "email": "dana@example.com", "firstName": "Dana", "lastName": "Reyes", "isCompany": false, "phone": "(406) 555-0142", "created": "2025-06-11T14:00:00", "updated": "2026-01-04T09:10:00", "language": "en", "icons": [], "portalStatus": "active" } ], "workOrderVendors": [] }