Event Calendar

Last Updated 7/1/2015

Conventions in this Document:

Text inbold is required. Text initalics should be substituted with the value of a parameter.

All URIs are relative to https://apps.il-work-net.com/.

API interfaces


Gets list of all events meeting the search criteria. All parameters are optional except radius, which is required if you specify a zip. NOTE: You will never find a grade level of "All" (id 1) or "Not Applicable" (id 19) in the database. "All" exists for the convenience of the user entering the event, and selects "Pre-Kindergarten" through "Technical" (ids 2-18). "Not Applicable" exists for validation purposes, to require that the user select at least one grade level. It is not stored in the database.
integer ID of the Calendar.
CSV list of calendar IDs (all integers).
CSV list of event type IDs (all integers).
Keyword to search on.
A single zipcode to use as a starting point for a search (specifying this requires also specifying miles).
Radius from zipcode to search within (required if zipcode is specified).
CSV of zipcodes to search near - useful for searching by LWIA or county.
Number of events to return.
Number of matches to skip before returning results.
Approved, Unapproved, or All
Name of the account that created the event
Start date for the events
End date for the events
CSV of Audience IDs (all integers)
CSV of Grade Level IDs (all integers)
CSV of Interest IDs (all integers)


GET/CalendarAPI/api/Audience/NoneGets list of all Audiences
GET/CalendarAPI/api/Audience/ididRetrieves the audience whose Id = id.

Bad Words

GET/CalendarAPI/api/Badwords/?inputtext=texttextChecks text for bad words.


GET/CalendarAPI/api/Calendar/NoneGets list of all available calendars
GET/CalendarAPI/api/Calendar/?defaultcalendar=truedefaultcalendarRetrieves the default calendar
GET/CalendarAPI/api/Calendar/ididRetrieves the calendar with Id = id.
POST/CalendarAPI/api/Calendar/CalendarDTOCreates the calendar specified in the CalendarDTO in the body of the request. CalendarDTO is a JSON object. Requires authentication.


GET/CalendarAPI/api/City/city=city&take=nbrcity is the start of a city name. take is the number of results to return.Lookup city from first few characters.
GET/CalendarAPI/api/City/zipcode=zipZipLookup city by zipcode.

Event Details

GET/CalendarAPI/api/EventDetails/ididGets Event details of the event whose Id = id.
DELETE/CalendarAPI/api/EventDetails/ididRetrieves the audience whose Id = id. Requires authentication.
POST/CalendarAPI/api/EventDetails/EventDTOCreates the event specified in the EventDTO in the body of the request. EventDTO is a JSON object. Requires authentication.
PUT/CalendarAPI/api/EventDetails/EventDTOUpdates the event specified in the EventDTO in the body of the request. EventDTO is a JSON object. Requires authentication.

Event Types

GET/CalendarAPI/api/EventTypesNoneGets list of all Event Types
GET/CalendarAPI/api/EventTypes/ididRetrieves the event type whose Id = id.
POST/CalendarAPI/api/EventTypes/EventTypeDTOCreates the event type specified in EventTypeDTO in the body of the request. EventTypeDTO is a JSON object. Requires authentication.

Fields of Interest

GET/CalendarAPI/api/FieldOfInterest/NoneGets list of all fields of interest.
GET/CalendarAPI/api/FieldOfInterest/ididRetrieves the field of interest whose Id = id.

Grade Level

GET/CalendarAPI/api/GradeLevel/NoneGets list of all grade levels.
GET/CalendarAPI/api/GradeLevel/ididRetrieves the grade level whose Id = id.


GET/CalendarAPI/api/iCal/ididRetrieves the event whose Id = id in iCal format, suitable for importing into Outlook or other calendars.






color1 and color2Calculates luminosity ratio for two colors, expressed as standard color names (e.g. Blue) or as hex codes. Useful for determining if two colors are accessible or not. Returns a float.

Spell Check

POST/CalendarAPI/api/SpellCheck/SpellDTOReturns JSON object with list of incorrect words or suggested words based on the action parameter.
GET/CalendarAPI/api/SpellCheck/SpellDTOReturns JSON object with list of incorrectly spelled words.

ZIP Code


/CalendarAPI/api/Zipcode/?zipcode=zip &take=take

zip – zip code fragment takenumber of results to return

Gets list of zipcodes based on partial string value of a zipcode. Used for autocomplete features for a zipcode field.
GET/CalendarAPI/api/FieldOfInterest/?city=citycityRetrieves a list of zipcodes for a city name.

Data Transfer Object (DTO) classes


  public class CalendarDTO 
    public int Id;  
    public string Name; 
    public bool Default; 
    public string Description; 


  public class EventDTO 
    public int Id; 
    public string Title; 
    public DateTime Start; 
    public DateTime StartUTC;  
    public DateTime End; 
    public DateTime EndUTC;  
    public string Code; 
    public string Description; 
    public string DescriptionHtml;  
    public bool Active; 
    public bool Virtual;  
    public string Url; 
    public bool AllDay;  
    public string Address;  
    public string City;  
    public string Zipcode; 
    public decimal Latitude; 
    public decimal Longitude;  
    public string ContactInfo; 
    public bool ApprovalRequired; 
    public bool Approved; 
    public DateTime ApprovalDate;  
    public string ApprovedById; 
    public DateTime RegistrationCloseDate; 
    public int EventTypeId; 
    public string EventTypeName; 
    public string CreatedById; 
    public DateTime CreatedDateUTC; 
    public string UpdatedById; 
    public string RemainingDates; 
    public string AllEventDates; 
    public bool ApproveAllEvents;
    public bool IsInOccurrence;
    public bool EditAsSingleEvent; 
    public int OccurrenceId; 
    public OccurrenceDTO Occurrence;
    public int CalendarId; 
    public string CalendarName;
    public virtual ICollection<AudienceDTO> Audiences; 
    public virtual ICollection<GradeLevelDTO> GradeLevels; 
    public virtual ICollection<FieldOfInterestDTO> FieldsOfInterest; 
    public ICollection<int> AudienceIDs; 
    public ICollection<int> GradeLevelIDs; 
    public ICollection<int> FieldsOfInterestIDs;
    public string GoogleCalendarURL; 
    public string LiveCalendarURL; 
    public string YahooCalendarURL; 

EventType DTO

  public class EventTypeDTO 
    public string Name; 


  public class EventTypeDTO 
    public string Name; 

IOER Site Footer

Copyright © 2012 - 2020 Illinois Department of Commerce and Economic Opportunity and Illinois State Board of Education

WEB11 | 2019-08-14a