Update contract fees | SchoolSet

curl -X PATCH https://app.schoolset.io/app/api/v1/services/contract/fees/update/id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "amount": 1500,
  "fees_plan": [
    {
      "amount": 500,
      "date": "2026-09-01T08:00:00-04:00"
    },
    {
      "amount": 500,
      "date": "2026-10-01T08:00:00-04:00"
    },
    {
      "amount": 500,
      "date": "2026-11-01T08:00:00-04:00"
    }
  ]
}'

{
  "status": "success",
  "message": "Contract fee record updated successfully.",
  "data": {
    "id": 12345,
    "type": "Tuition Fee",
    "contract_fees_type_id": 2,
    "due_date": "2026-09-01T08:00:00-04:00",
    "of_installments": 3,
    "grace_period": 15,
    "discount": 150,
    "amount": 1500,
    "final_amount": 1350,
    "total_paid": 500,
    "total_upcoming": 850,
    "student": {},
    "contract_fees_period": {},
    "fees_plan": [
      {}
    ],
    "responsible_id": 789,
    "responsible_type": "Parent",
    "responsible_note": "Payment plan agreed upon with guardian.",
    "responsible": {
      "id": 789,
      "name": "Jane Doe"
    },
    "payments": [
      {
        "id": 101,
        "payment_date": "2026-09-01T08:00:00-04:00",
        "amount_payment": 500,
        "payment_status_id": 1,
        "allocated_amount": 500
      }
    ]
  }
}

Updates the selected contract fee record.

Authentication

AuthorizationBearer

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Path parameters

idstringRequired

Request

This endpoint expects an object.

amountdoubleRequired

Must be at least 0.

fees_planlist of objectsRequired

fees plan list.

contract_fees_type_iddouble or nullOptional

contract fees type ID identifier.

contract_iddouble or nullOptional

contract ID identifier.

student_iddouble or nullOptional

student ID identifier.

due_datestring or nullOptional

Must be a valid date. Must be a valid date in the format Y-m-d\TH:i:sP.

of_installmentsinteger or nullOptional

Number of installments used to split the fee.

grace_perioddouble or nullOptional

Must be at least 0.

discountdouble or nullOptional

discount numeric value.

contract_fees_period_iddouble or nullOptional

contract fees period ID identifier.

Response

Successful PATCH response for /api/v1/services/contract/fees/update/{id}.

statusstring

messagestring

dataobject