Document bns api

[orkunkl]

Adding documentation to the REST API:

• we need an example of a query of each endpoint using curl