GET: ALL STAFF

Type: GET

Method: staffs

Parameter: none

URL Example: https://www.bizstim.com/api/staffs

Response Example:
{
    "status": "success",
    "response": [
        {
            "id": "31",
            "users_id": "5290",
            "staff_settings_id": "35",
            "first_name": "mark",
            "last_name": "phastic2",
            "address1": "Easy Street",
            "address2": "201",
            "city": "Hamilton",
            "state": "Ontario",
            "zipcode": "L8R 2M6",
            "country": "Canada",
            "p_phone": "(905) 555-1111",
            "s_phone": "(905) 555-2222"
        },
        {
            ...
        }
    ]
}

Element Properties:
ELEMENT TYPE DESCRIPTION
id integer Unique id.
users_id integer Unique id. id on the users table
staff_settings_id integer Unique id. id on the staff_settings table
first_name string First name for the staff member
last_name string Last name for the staff member
address1 string Street address for the staff member
address2 string Suite or appartment number for the staff member
city string City location for the staff member
state string State location for the staff member
zipcode string Zipcode location for the staff member
country string Country location for the staff member
p_phone string Primary phone number for the staff member
s_phone string Secondary phone number for the staff member

GET: MEET OUR STAFF

Type: GET

Method: meetourstaff

Parameter: none

URL Example: https://www.bizstim.com/api/meetourstaff

Response Example:
{
    "status": "success",
    "response": [
        {
            "admin_id": "15",
            "staff_id": "757",
            "staff_settings_id": "819",
            "first_name": "joanna",
            "last_name": "smiley",
            "position": "Founder & CEO",
            "excerpt": "<span class=\"excerpt\">Maecenas sagittis malesuada
                ligula at vulputate. Integer nec fermentum lorem, aliquam faucibus tortor. Phasellus in
                commodo</span>",
            "priority": "10"
            "headshot_url": "jsmiley.png"
        },
        {
             ...
        }
    ]
}

Element Properties:
ELEMENT TYPE DESCRIPTION
admin_id integer Unique id. id on the staff table
staff_settings_id integer Unique id. id on the staff_settings table
staff_id integer Unique id. id on the staff table
first_name string First name for the staff
last_name string Last name for the staff
position string Staff user's position with the company. For example; Marketing Manager, Sales Manager, Chief Operating Officer. 100 character maximum length
excerpt string A short description of the staff user's roles and responsibilities. 210 character maximum length
priority integer Choose a number between 1 and 100. 1 has the highest priority. This is used to determine the order of appearance for our Meet Our Staff API and WordPress plugin. You can keep this at the default setting if you do not intend to use the API.
headshot_url string

Filename of an image or pic that has been uploaded to their account by the administrator. This will be blank.png for those who do not have a pic. This field could also be an empty string.

If this value is empty or blank.png, use the following url to point to the file:

https://www.bizstim.com/assets/backend/images/headshots/blank.png

If this value is not empty and is not blank.png, use the following url to point to the file:

https://www.bizstim.com/assets/backend/images/headshots/staff/admin-{admin_id}/staff-{staff_settings_id}/{headshot_url}

Additional Information

ORDER OF THE QUERY.   The response is ordered by priority in ascending order.   If two or more staff users have the same priority, they are then ordered by first name in ascending order.   This was done to help you show the staff users in a logical order that was previously predetermined by you.  

GET: STAFF

Type: GET

Method: staff

Parameter: (integer) {staff_id}

URL Example: https://www.bizstim.com/api/staff/31

Response Example:
{
    "status": "success",
    "response": {
        "id": "31",
        "users_id": "5290",
        "staff_settings_id": "35",
        "first_name": "mark",
        "last_name": "phastic2",
        "address1": "Easy Street",
        "address2": "201",
        "city": "Hamilton",
        "state": "Ontario",
        "zipcode": "L8R 2M6",
        "country": "Canada",
        "p_phone": "(905) 555-1111",
        "s_phone": "(905) 555-2222"
    }
}

* See element properties from PRACTITIONERS for a list of the elements and their properties.

GET: STAFF SETTINGS

Type: GET

Method: staffsettings

Parameter: (integer) {staff_settings_id}

URL Example: https://www.bizstim.com/api/staffsettings/35

Response Example:
{
    "status": "success",
    "response": {
        "id": "35",
        "status": "active",
        "calendar_color": "#b6d7a8",
        "hire_date": "2017-06-13",
        "wage_tier": "1",
        "notes": "",
        "send_welcome_message": "1",
        "s_practs": "1",
        "s_staff": "3",
        "s_wages": "1",
        "s_timesheets": "4",
        "s_deductions": "1",
        "s_skills": "1",
        "s_clients": "1",
        "s_assess": "1",
        "s_scheduling": "1",
        "s_revenues": "1",
        "s_balances": "1",
        "s_invoices": "1",
        "s_expenses": "1",
        "s_services": "1",
        "s_taxes": "1",
        "s_session_control": "2",
        "s_reconcile_duration": "1",
        "s_costs_wages": "1",
        "s_locations": "1",
        "s_import": "1",
        "s_langtrans": "1",
        "s_notif": "1",
        "pract_mass_email": "1",
        "client_mass_email": "1",
        "staff_mass_email": "1",
        "s_email_history": "1",
        "s_tasks": "1",
        "s_branding": "1",
        "s_permissions": "1",
        "s_leads": "1"
    }
}

Element Properties:
ELEMENT TYPE DESCRIPTION
id integer Unique id.
status string active | inactive | contactList | doNotHire
calendar_color string Color of blocks shown on the timesheets calendar
hire_date string Date the staff user was added to the database
wage_tier integer Wage type for the practitioner. 1 = hourly salary | 2 = annual salary
notes string Staff notes as seen on the add, edit, and view staff pages
send_welcome_message integer Send welcome message upon account creation. 0 = no, 1 = yes
s_practs integer Manage practitioners. 0 = no, 1 = yes
s_staff integer Manage staff. 0 = No | 1 = view only | 2 = view and edit | 3 = view, add, edit, and delete
s_wages integer Manage hours and wages. 0 = no, 1 = yes
s_timesheets integer Manage timesheets. 0 = No | 1 = view all timesheets | 2 = manage practitioner timesheets only | 3 = manage staff timesheets only | 4 = manage timesheets
s_deductions integer Manage deductions. 0 = no, 1 = yes
s_skills integer Manage skills. 0 = no, 1 = yes
s_clients integer Manage clients. 0 = no, 1 = yes
s_assess integer Manage assessments. 0 = no, 1 = yes
s_scheduling integer Manage pre-scheduling. 0 = no, 1 = yes
s_revenues integer Manage payments. 0 = no, 1 = yes
s_balances integer Manage balances. 0 = no, 1 = yes
s_invoices integer Manage invoices. 0 = no, 1 = yes
s_expenses integer Manage expenses. 0 = no, 1 = yes
s_services integer Manage services. 0 = no, 1 = yes
s_taxes integer Manage taxes. 0 = no, 1 = yes
s_session_control integer Manage sessions. 0 = view only | 1 = save and edit | 2 = save, add, edit, and delete
s_reconcile_duration integer Ability to change session start and end times. 0 = no, 1 = yes
s_costs_wages integer See costs and wages of sessions. 0 = no, 1 = yes
s_locations integer Manage locations. 0 = no, 1 = yes
s_import integer Manage data imports and exports. 0 = no, 1 = yes
s_langtrans integer Manage language translation. 0 = no, 1 = yes
s_notif integer Manage notification messages. 0 = no, 1 = yes
pract_mass_email integer Send practitioner mass e-mails. 0 = no, 1 = yes
client_mass_email integer Send client mass e-mails. 0 = no, 1 = yes
staff_mass_email integer Send staff mass e-mails. 0 = no, 1 = yes
s_email_history integer Manage e-mail history. 0 = no, 1 = yes
s_tasks integer Manage tasks. 0 = no, 1 = yes
s_branding integer Manage branding and colors. 0 = no, 1 = yes
s_permissions integer Manage permissions. * Staff user will NOT be able to manage their own permissions. 0 = no, 1 = yes
s_leads integer Manage sales manager. 0 = no, 1 = yes