Create contract fees | SchoolSet

curl -X POST https://app.schoolset.io/app/api/v1/services/contract/fees/create \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "contract_fees_type_id": 102,
  "contract_id": 15,
  "students_id": [
    101,
    102,
    103
  ],
  "responsible_id": 45,
  "responsible_type": "parent",
  "due_date": "2026-09-15T12:00:00-04:00",
  "of_installments": 4,
  "amount": 1200,
  "contract_fees_period_id": 202,
  "fees_plan": [
    {
      "date": "2026-09-15T12:00:00-04:00",
      "amount": 300
    },
    {
      "date": "2026-10-15T12:00:00-04:00",
      "amount": 300
    },
    {
      "date": "2026-11-15T12:00:00-04:00",
      "amount": 300
    },
    {
      "date": "2026-12-15T12:00:00-04:00",
      "amount": 300
    }
  ]
}'

{
  "status": "success",
  "message": "Contract fees successfully created.",
  "data": {
    "id": 789,
    "type": "tuition",
    "contract_fees_type_id": 102,
    "due_date": "2026-09-15T12:00:00-04:00",
    "of_installments": 4,
    "grace_period": 15,
    "discount": 150,
    "amount": 1200,
    "final_amount": 1050,
    "total_paid": 300,
    "total_upcoming": 750,
    "student": {},
    "contract_fees_period": {},
    "fees_plan": [
      {}
    ],
    "responsible_id": 45,
    "responsible_type": "parent",
    "responsible_note": "Payment plan agreed upon with parent.",
    "responsible": {
      "id": 45,
      "name": "Jane Doe"
    },
    "payments": [
      {
        "id": 501,
        "payment_date": "2026-09-15T12:00:00-04:00",
        "amount_payment": 300,
        "payment_status_id": 2,
        "allocated_amount": 300
      }
    ]
  }
}

Creates contract fee data from submitted details.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

contract_fees_type_iddoubleRequired

contract fees type ID identifier.

contract_iddoubleRequired

contract ID identifier.

students_idlist of integersRequired

Student IDs included in this request.

responsible_iddoubleRequired

responsible ID identifier.

responsible_typeenumRequired

responsible type value.

Allowed values:

due_datestringRequired

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

of_installmentsintegerRequired

Number of installments used to split the fee.

amountdoubleRequired

Must be at least 0.

contract_fees_period_iddoubleRequired

contract fees period ID identifier.

fees_planlist of objectsRequired

fees plan list.

responsible_notestring or nullOptional

Must not be greater than 255 characters.

grace_perioddouble or nullOptional

Must be at least 0.

discountdouble or nullOptional

discount numeric value.

Response

Successful POST response for /api/v1/services/contract/fees/create.

statusstring

messagestring

dataobject