ASN Web Services Overview

The ASN REST based web services revolve around document retrieval. Requests return a XML response with appropriate metadata. Start at the most basic requests of all subjects or all jurisdictions in the ASN. Use those returns to filter ASN Standards Documents by subject, jurisdiction, and publication status to match your needs.

We kindly ask that you cache and/or store the below ASN Web Service responses if you are building them into an application.

Jurisdictions API:

Request a listing of all jurisdictions in the ASN:

http://asn.jesandco.org/api/1/jurisdictions

Filter jurisdictions by class e.g. Organizations, U.S. States and Territories:

http://asn.jesandco.org/api/1/jurisdictions?class=Organization

http://asn.jesandco.org/api/1/jurisdictions?class=U.S.%20States%20and%20Territories

Subjects API:

Request a listing of all subjects in the ASN:

http://asn.jesandco.org/api/1/subjects

Documents API

Finally, filter ASN Standards Documents by a number of parameters. You may use human readable or URI parameters.

Submit human readable parameters using:

1. &jurisdiction
2. &status
3. &subject

Submit URI parameters using:

1. &jurisdictionURI
2. &statusURI
3. &subjectURI

You may mix and match between human readable and URI parameters in the same request. Jurisdiction or JurisdictionURI is required and may only appear once. Status or StatusURI may only appear once. Subject and SubjectURI may be repeated as often as needed. Omit either the subject(URI) or status(URI) to return all.

Let’s have a look at a few examples:

Request all ASN Standards Documents from Arkansas using the human readable jurisdiction parameter:

http://asn.jesandco.org/api/1/documents?jurisdiction=ar

Same request but using the jurisdiction URI parameter:

http://asn.jesandco.org/api/1/documents?jurisdictionURI=http%3A%2F%2Fpurl.org%2FASN%2Fscheme%2FASNJurisdiction%2FAR

Request all Arkansas, Math, Published ASN Standards Documents:

http://asn.jesandco.org/api/1/documents?jurisdiction=ar&subject=math&status=published

Same request but using jurisdictionURI, subjectURI and statusURI parameters:

http://asn.jesandco.org/api/1/documents?jurisdictionURI=http%3A%2F%2Fpurl.org%2FASN%2Fscheme%2FASNJurisdiction%2FAR&subjectURI=http%3A%2F%2Fpurl.org%2FASN%2Fscheme%2FASNTopic%2Fmath&statusURI=http%3A%2F%2Fpurl.org%2FASN%2Fscheme%2FASNPublicationStatus%2FPublished

Request all Arkansas math, science and social studies ASN Standards Documents:

http://asn.jesandco.org/api/1/documents?jurisdiction=ar&subject=math&subject=science&subject=social%20studies