Add new endpoint, proper documentation

I believe you can just pass revenue in as `nil`, so no need for the check. Though I could be wrong...