The following page describes the FOAM API using a swagger definition.
You can find the raw swagger.json file here
swagger.json
Click here