add term info in response, update documentation