1. TeacherPayments
ScuolaSemplice Web API
  • v2
    • Payments
      • registerInstallmentPayment
    • Orders
      • fetchUserOrders
    • Aggregator
      • Update timetable
      • Booking lesson
      • Cancel booking
      • Set attendances
    • Custom fields
      • Read all custom fields
      • Fetch ustom field
    • Workflows
      • Returns list of all workflows
      • Start a new workflow instance
    • StudyPlans
      • Returns list of all study plans
    • Subscriptions
      • fetchSubscriptions
      • Subscribe a student to a class
      • Alter subscriprion of a student to a class
    • Classes
      • Retuns list of class models
      • Creates a class model / catalogue
      • Updates a class model / catalogue
      • Creates a class from a model
      • Reads all list of classes from archive
      • Reads all classes added or updated after timestamp
    • Students
      • Reads paginated list of students
      • Fetch student
      • Creates new student and return the id
      • Updates an existing student and return the id
      • Reads all list of students from archive
      • Reads all students added or updated after timestamp
    • Catalogues
      • Returns list of system branches
      • Returns list of classes custom fields
      • Returns list of all locations
  • v3
    • Classes
      • classes
      • classes/{id}
    • Exams
      • exams
      • exams/{id}
    • Lessons
      • lessons
      • lessons/{id}
    • Orders
      • orders
      • orders/{id}
      • Order creation
    • PackageOffers
      • packageoffers
      • packageoffers/{id}
    • ProfileCustomSelectValues
      • profilecustomselectvalues
    • Payments
      • payments
      • payments/{id}
    • QrReadings
      • qrreadings
      • qrreadings/{id}
      • qrreadings
    • Students
      • students
      • students/{id}
      • create
      • update
      • update by externid
      • create student comment
    • Teachers
      • teachers/{id}
      • teachers
      • create
      • update
      • update by externid
    • CustomerCompanies
      • customercompanies
      • customercompanies/{id}
    • Subscriptions
      • classes
        • subscriptions/classes
        • subscriptions/classes/{id}
        • create subscription class
      • exams
        • subscriptions/exams
        • subscriptions/exams/{id}
        • create subscription exam
      • studyplans
        • subscriptions/studyplans
        • subscriptions/studyplans/{id}
    • Tutors
      • tutors
      • tutors/{id}
    • Transactions
      • Create
      • Delete
    • TeacherPayments
      • List teacher payments
        GET
      • Get a teacher payment by id
        GET
    • subscriptions
      GET
  • Schemas
    • Schemas
      • Generic key value parameters
      • Generic parameters array
      • CustomFieldValue
      • user
      • inline_response_200
      • parameters_1
      • parameters_2
      • parameters_3
      • inline_response_200_1
      • parameters_4
      • parameters_5
      • parameters_6
    • Aggregator
      • Lesson
      • Course timetable
      • Attendance
    • ErrorBadRequest
    • StudyPlan
    • TeacherPaymentLine
    • TeacherPayment
    • PaginationLinks
    • PaginationMeta
    • TeacherPaymentCollection
  1. TeacherPayments

List teacher payments

GET
/api/v3/teacherpayments
Last modified:2026-08-24 12:23:27
Elenco paginato dei movimenti docente.
Serve o period o la coppia fromDate+toDate (non entrambi).
Ogni elemento include sempre tutte le lines (salvo filterLinesByCompetence=1
in modalità range, che filtra le sole righe di competenza).

Request

Authorization
Basic Auth
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://prod.your-api-server.com/api/v3/teacherpayments?period=&fromDate=&toDate=&teacherid=&fiscalcompanyid=&status=&filterLinesByCompetence=&pagesize=&page=' \
--header 'Authorization: Basic <encoded-value>'

Responses

🟢200
application/json
Paginated teacher payments
Bodyapplication/json

Example
{
    "data": [
        {
            "id": 5012,
            "teacherid": 42,
            "teachername": "Mario Rossi",
            "fiscalcompanyid": 3,
            "companycode": "ACME",
            "companyname": "Acme Formazione Srl",
            "period": "2026-04",
            "title": "Aprile 2026",
            "description": "Pagamento delle lezioni tenute nel periodo aprile 2026",
            "amount": 450,
            "status": 0,
            "emissiondate": "2026-05-05",
            "paymentdate": null,
            "billingmethod": "none",
            "lines": [
                {
                    "id": 9001,
                    "type": "lesson",
                    "paymentid": 5012,
                    "paymentdetailid": null,
                    "teacherid": 42,
                    "competencedate": "2026-04-01",
                    "competencestart": null,
                    "competenceend": null,
                    "period": "2026-04",
                    "classid": 100,
                    "classname": "Corso di esempio",
                    "classcode": "C-100",
                    "lessonid": 7001,
                    "lessonids": [
                        7001
                    ],
                    "locationid": 10,
                    "locationname": "Sede Online",
                    "amount": 150,
                    "durationminutes": 120,
                    "distancekm": null,
                    "triprefund": null,
                    "overnightrefund": null,
                    "description": null,
                    "studyplanids": [
                        5
                    ],
                    "studyplans": [
                        {
                            "id": 5,
                            "code": "PLAN-DEMO",
                            "name": "Piano Demo",
                            "label": "Edizione Demo - Piano Demo"
                        }
                    ]
                }
            ]
        }
    ],
    "links": {
        "first": "https://tenant.scuolasemplice.it/api/v3/teacherpayments?period=2026-04&status=0&pagesize=50&page=1",
        "last": "https://tenant.scuolasemplice.it/api/v3/teacherpayments?period=2026-04&status=0&pagesize=50&page=2",
        "prev": null,
        "next": "https://tenant.scuolasemplice.it/api/v3/teacherpayments?period=2026-04&status=0&pagesize=50&page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "path": "https://tenant.scuolasemplice.it/api/v3/teacherpayments",
        "per_page": 50,
        "to": 50,
        "total": 67
    }
}
🟠400
🟠403
Modified at 2026-08-24 12:23:27
Previous
Delete
Next
Get a teacher payment by id
Built with