API clinics

From Charitylog Manual
Jump to: navigation, search

Go to API overview

Attendances

Attendances are the planned and actual attendances at meetings. They can be retrieved, typically by filtering on project and date, using:

[GET] https://api.dizions.co.uk/v2/attendances/project/1/start/2024-12-01,2024-12-31/attended/Y

Note the /attended/Y filter. Non-attendances can be used using /attended/N.

You may also want to filter by the clinic, e.g. this will add a filter to only show attendances at clinics 3 and 7.

[GET] https://api.dizions.co.uk/v2/attendances/clinic/3;7

To select specific fields, add them after /field, e.g.

[GET] https://api.dizions.co.uk/v2/attendances/start/2024-12-01,2024-12-31/field/client;attended

To see a list of selectable fields, use:

[GET] https://api.dizions.co.uk/v2/attendances/selectable_fields

Clinics

Clinics are the names of the groups, after-school clubs, day centres etc that your organisation runs. They can be retrieved using:

[GET] https://api.dizions.co.uk/v2/clinics

You can also filter, typically by project:

[GET] https://api.dizions.co.uk/v2/clinics/project_id/5

To select specific fields, add them after /field:

[GET] https://api.dizions.co.uk/v2/clinics/field/id;name;maximum_number_of_members

To see a list of selectable fields, use:

[GET] https://api.dizions.co.uk/v2/clinics/selectable_fields

Typically you would use this list as a lookup list for attendances

Rates

Rates are like any other field. Add /field/rate to /attendances to get the rate for each attendance

[GET] https://api.dizions.co.uk/v2/attendances/start/2024-12-01,2024-12-31/field/client;attended;rate

To get a list of rates, use the dictionary:

[GET] https://api.dizions.co.uk/v2/dictionary/rates

Treatments and Activities

These are the extra things like lunch that can be added to attendance. Add /field/treatments to /attendances to get a list of each treatment for each attendance, with the properties: ticked (Y/N), paid (Y/N), treatment (the id of treatment), amount_paid.

[GET] https://api.dizions.co.uk/v2/attendances/start/2024-12-01,2024-12-31/field/client;attended;treatments

To get a list of treatment, use the dictionary:

[GET] https://api.dizions.co.uk/v2/dictionary/treatments