Create fee

Create a new fee record for a student.

POST /api/finance/create

cURL

curl --request POST \
  --url http://localhost:5000/api/finance/create \
  --header 'Content-Type: application/json' \
  --data '{
    "studentId": "64a1f2c3e4b0d5f6a7b8c9d0",
    "amount": 250.00,
    "status": "PENDING"
  }'

200

{
  "_id": "64c5d8b3e2f1a0b4c5d6e7f8",
  "studentId": "64a1f2c3e4b0d5f6a7b8c9d0",
  "amount": 250,
  "status": "PENDING",
  "__v": 0
}

Creates a new fee record and saves it to the database. Fee records track amounts owed by students and their current payment status.

No authentication is required to call this endpoint.

Request body

studentId · string · required

The MongoDB ObjectId of the student the fee is assigned to.

amount · number · required

The monetary amount of the fee.

status · string · required

The payment status of the fee. Common values: PENDING, PAID, OVERDUE.

Response

Returns the newly created fee object.

_id · string

The unique MongoDB ObjectId assigned to the fee record.

studentId · string

The MongoDB ObjectId of the student the fee belongs to.

amount · number

The monetary amount of the fee.

status · string

The current payment status of the fee.

__v · number

Internal MongoDB document version key.

cURL

curl --request POST \
  --url http://localhost:5000/api/finance/create \
  --header 'Content-Type: application/json' \
  --data '{
    "studentId": "64a1f2c3e4b0d5f6a7b8c9d0",
    "amount": 250.00,
    "status": "PENDING"
  }'

200

{
  "_id": "64c5d8b3e2f1a0b4c5d6e7f8",
  "studentId": "64a1f2c3e4b0d5f6a7b8c9d0",
  "amount": 250,
  "status": "PENDING",
  "__v": 0
}