MTurkR (version 0.5)

GetBonuses: Get Bonus Payments

Description

Get details of bonuses paid to workers, by HIT, HITType, or Assignment.

Usage

GetBonuses(assignment = NULL, hit = NULL, hit.type = NULL, return.all = TRUE, 
           pagenumber = "1", pagesize = "100",
           verbose = getOption('MTurkR.verbose'), ...)

Arguments

assignment

An optional character string containing an AssignmentId whose bonuses should be returned.

hit

An optional character string containing a HITId whose bonuses should be returned.

hit.type

An optional character string containing a HITTypeId (or a vector of HITTypeIds) whose bonuses should be returned.

return.all

A logical indicating whether all HITs (as opposed to a specified page of the search results) should be returned. Default is TRUE. Note: This is (temporarily) ignored.

pagenumber

An optional character string indicating which page of search results should be returned. Most users can ignore this.

pagesize

An optional character string indicating how many search results should be returned by each request, between 1 and 100. Most users can ignore this.

verbose

Optionally print the results of the API request to the standard output. Default is taken from getOption('MturkR.verbose').

...

Additional arguments passed to request.

Value

A dataframe containing the details of each bonus, specifically: AssignmentId, WorkerId, Amount, CurrencyCode, FormattedPrice, Reason, and GrantTime.

Details

Retrieve bonuses previously paid to a specified HIT, Assignment, or HITType.

bonuses() is an alias.

References

API Reference

See Also

GrantBonus

Examples

# NOT RUN {
GetBonuses(hit="2MQB727M0IGF304GJ16S1F4VE3AYDQ")
GetBonuses(assignment="26XXH0JPPSI23H54YVG7BKLO82DHNU")
# }