### Problem Description [SOLUTION](SOLUTION.md)

#### Background

The Government of Alberta manages the issuing of "well licenses" to companies or agencies who are interested in drilling for oil in the province. They want to deliver information about well licenses to companies and users through a mobile app and also a web app.

The task is to create a "well license" information API which will be consumed by the mobile app and a web app. 

**Note:** This one API will service both apps.

A typical well license has the following structure (all fields are required):

* Well License ID
* Name of Applicant
* Well Type (list of available values)
    * NFW: New Field Wildcat
    * NPW: New Pool Wildcat
    * DPT: Deeper Pool Test
    * SPT: Shallower Pool Test
    * DEV: Development Well
* Applying Company/Agency
* Latitude
* Longitude
* Township Name
* Date of License
* License Status (list of available values)
    * Active
    * Confidential
    * Expired

#### Requirements

1. The API will generate:
    * a list of all well licenses
    * a list of all non-expired well licenses for a particular company/agency
    * details of one well license
    * a list of active well licenses for a particular township, for a specific company/agency

2. Anonymous users, without logging in, can query the API these four ways, and retrieve JSON responses. 

    **Note:** The assignment does not require any styled views over the JSON responses. We just want to see the JSON.

3. A confidential well should never have the following fields returned by the API:
    * Name of Applicant
    * Well Type
    * Applying Company/Agency

4. Considering that this API will serve a mobile app, we want to reduce the number of API calls needed for one view request. So, the names of all the Well Types must always accompany a well license response, to populate a view drop-down list without making another API call.

5. Similar to '4', a listing of the different types of License Status must accompany any well license response.

#### Technical Notes

1. The API should ideally be deployed/hosted on heroku, or any hosted API endpoint of your choice that can be accessed by PetroFeed in Calgary.

2. Your submission can be developed using any technology/language you like.

3. This private Github repo has been created just for you. Please push your code to it for review.