For the records - the ASA API Documentation is on the device available once the API package has been installed and enabled. Just point your browser to https://[your-asa-mgmt-ip]/doc
The documentation gives examples and enables as well direct interaction with the asa for real data.
Installation Instruction on the API:
http://www.cisco.com/c/en/us/td/docs/security/asa/api/qsg-asa-api.html