Getting Started
Administrators are able to automate the export of ACT Score Report files using the Encoura platform's Application Programming Interface (API). The API is accessible with proper authorization and credentials from Encoura Member Support & Services. If you have not received your username, password, OrganizationId, and/or apiKey from Encoura, please contact support@encoura.org.
Once approved, you will be supplied with a service account username and password, an OrganizationID, and an apiKey to interact with the API. You may also access comprehensive documentation (attached below) and sample scripts for your developers to set up this capability for your organization.
Frequently Asked Questions
Where do I find specifications for the exported files?
The file layout information is available in the Encoura Help Center.
Can I get a sample file showing me what the exported file will look like?
A sample file is available in the Encoura Help Center.
Can I export Prospect files?
Not at this time. The API is designed to automate the export process for ACT Score Report files.
The parameter shown is NotDelivered, are there other query parameters available?
At this time the API is designed to provide access to new files not yet exported. Only the NotDelivered parameter is available. Files are marked as NotDelivered until they are returned in a list of available files.
Is there a way to use date parameters to limit the files returned using the API?
While you can't use a date parameter, the API will, by design, only return files from the previous 14 days.
If the only parameter available is NotDelivered, what is the best way to test the API while in development?
When you get your list of available files, the UID for each file can be saved and re-used to request a new download URL as many times as you need for testing purposes.
Why do I get an error when I try to log in?
Be sure you are including the required headers. See the attached documentation.