The Aeries API is a REST API. Current endpoints use primarily the HTTP GET verb. The POST, PUT, and DELETE verbs are supported for certain APIs, with more expected in the future.
Request Header
You will use the Request Header to tell the Aeries API what format you want the response (JSON or XML) and also what your certificate is. For the response format, include the following:
- XML
- Accept: text/xml, text/html, application/xhtml+xml, */*
- JSON
- Accept: application/json, text/html, application/xhtml+xml, */*
To give the system your certificate with each request:
- AERIES-CERT: 477abe9e7d27439681d62f4e0de1f5e1
The certificate is case sensitive!
Query String Filters
All API end points support a query string parameter named DatabaseYear to retrieve data from a specific school year’s database. The DatabaseYear parameter should be in the format of “YYYY”, using the year at the start of the school year (e.g., ?DatabaseYear=2020 for the 2020-2021 school year). If the DatabaseYear parameter is omitted, invalid, or does not match an available school year in the customer’s configuration, then the API will connect to the customer’s Default Year instead, which in most cases is the current school year.
Certain API end points, such as Student Information and Programs, support query string parameters to filter the records returned. These parameters are documented with each applicable end point.
Error Messages
As much as possible, human-readable errors will be returned by the endpoints described below. If the HTTP status code in the response indicates an error (code 400 or above), the response body should be parsed for the detailed error message.
Errors may occur for several reasons. Attempting to retrieve a single object that does not exist will result in a 404 Not Found error. A violation of other business rules or key constraints in a POST or PUT request will result in a 400 Bad Request error. For example, attempting to create a new staff job assignment with a non-existent Staff ID will generate an error.
Error Example (JSON):
Sample Code
C# - This will return the list of schools using the V5 API:
Other Notes
Dates that contain NULL values will use the following format in XML:
In previous versions of the API, this same information would have been output like: