View Source Stripe.Reporting.ReportRun (stripity_stripe v3.2.0)
The Report Run object represents an instance of a report type generated with specific run parameters. Once the object is created, Stripe begins processing the report. When the report has finished running, it will give you a reference to a file where you can retrieve your results. For an overview, see API Access to Reports.
Note that certain report types can only be run based on your live-mode data (not test-mode data), and will error when queried without a live-mode API key.
Summary
Types
Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the API Access to Reports documentation.
The reporting.report_run
type.
Functions
Creates a new object and begin running the report. (Certain report types require a live-mode API key.)
Returns a list of Report Runs, with the most recent appearing first.
Retrieves the details of an existing Report Run.
Types
@type parameters() :: %{ optional(:columns) => [binary()], optional(:connected_account) => binary(), optional(:currency) => binary(), optional(:interval_end) => integer(), optional(:interval_start) => integer(), optional(:payout) => binary(), optional(:reporting_category) => :advance | :advance_funding | :anticipation_repayment | :charge | :charge_failure | :climate_order_purchase | :climate_order_refund | :connect_collection_transfer | :connect_reserved_funds | :contribution | :dispute | :dispute_reversal | :fee | :financing_paydown | :financing_paydown_reversal | :financing_payout | :financing_payout_reversal | :issuing_authorization_hold | :issuing_authorization_release | :issuing_dispute | :issuing_transaction | :network_cost | :other_adjustment | :partial_capture_reversal | :payout | :payout_reversal | :platform_earning | :platform_earning_refund | :refund | :refund_failure | :risk_reserved_funds | :tax | :topup | :topup_reversal | :transfer | :transfer_reversal | :unreconciled_customer_funds, optional(:timezone) => :"Africa/Abidjan" | :"Africa/Accra" | :"Africa/Addis_Ababa" | :"Africa/Algiers" | :"Africa/Asmara" | :"Africa/Asmera" | :"Africa/Bamako" | :"Africa/Bangui" | :"Africa/Banjul" | :"Africa/Bissau" | :"Africa/Blantyre" | :"Africa/Brazzaville" | :"Africa/Bujumbura" | :"Africa/Cairo" | :"Africa/Casablanca" | :"Africa/Ceuta" | :"Africa/Conakry" | :"Africa/Dakar" | :"Africa/Dar_es_Salaam" | :"Africa/Djibouti" | :"Africa/Douala" | :"Africa/El_Aaiun" | :"Africa/Freetown" | :"Africa/Gaborone" | :"Africa/Harare" | :"Africa/Johannesburg" | :"Africa/Juba" | :"Africa/Kampala" | :"Africa/Khartoum" | :"Africa/Kigali" | :"Africa/Kinshasa" | :"Africa/Lagos" | :"Africa/Libreville" | :"Africa/Lome" | :"Africa/Luanda" | :"Africa/Lubumbashi" | :"Africa/Lusaka" | :"Africa/Malabo" | :"Africa/Maputo" | :"Africa/Maseru" | :"Africa/Mbabane" | :"Africa/Mogadishu" | :"Africa/Monrovia" | :"Africa/Nairobi" | :"Africa/Ndjamena" | :"Africa/Niamey" | :"Africa/Nouakchott" | :"Africa/Ouagadougou" | :"Africa/Porto-Novo" | :"Africa/Sao_Tome" | :"Africa/Timbuktu" | :"Africa/Tripoli" | :"Africa/Tunis" | :"Africa/Windhoek" | :"America/Adak" | :"America/Anchorage" | :"America/Anguilla" | :"America/Antigua" | :"America/Araguaina" | :"America/Argentina/Buenos_Aires" | :"America/Argentina/Catamarca" | :"America/Argentina/ComodRivadavia" | :"America/Argentina/Cordoba" | :"America/Argentina/Jujuy" | :"America/Argentina/La_Rioja" | :"America/Argentina/Mendoza" | :"America/Argentina/Rio_Gallegos" | :"America/Argentina/Salta" | :"America/Argentina/San_Juan" | :"America/Argentina/San_Luis" | :"America/Argentina/Tucuman" | :"America/Argentina/Ushuaia" | :"America/Aruba" | :"America/Asuncion" | :"America/Atikokan" | :"America/Atka" | :"America/Bahia" | :"America/Bahia_Banderas" | :"America/Barbados" | :"America/Belem" | :"America/Belize" | :"America/Blanc-Sablon" | :"America/Boa_Vista" | :"America/Bogota" | :"America/Boise" | :"America/Buenos_Aires" | :"America/Cambridge_Bay" | :"America/Campo_Grande" | :"America/Cancun" | :"America/Caracas" | :"America/Catamarca" | :"America/Cayenne" | :"America/Cayman" | :"America/Chicago" | :"America/Chihuahua" | :"America/Ciudad_Juarez" | :"America/Coral_Harbour" | :"America/Cordoba" | :"America/Costa_Rica" | :"America/Creston" | :"America/Cuiaba" | :"America/Curacao" | :"America/Danmarkshavn" | :"America/Dawson" | :"America/Dawson_Creek" | :"America/Denver" | :"America/Detroit" | :"America/Dominica" | :"America/Edmonton" | :"America/Eirunepe" | :"America/El_Salvador" | :"America/Ensenada" | :"America/Fort_Nelson" | :"America/Fort_Wayne" | :"America/Fortaleza" | :"America/Glace_Bay" | :"America/Godthab" | :"America/Goose_Bay" | :"America/Grand_Turk" | :"America/Grenada" | :"America/Guadeloupe" | :"America/Guatemala" | :"America/Guayaquil" | :"America/Guyana" | :"America/Halifax" | :"America/Havana" | :"America/Hermosillo" | :"America/Indiana/Indianapolis" | :"America/Indiana/Knox" | :"America/Indiana/Marengo" | :"America/Indiana/Petersburg" | :"America/Indiana/Tell_City" | :"America/Indiana/Vevay" | :"America/Indiana/Vincennes" | :"America/Indiana/Winamac" | :"America/Indianapolis" | :"America/Inuvik" | :"America/Iqaluit" | :"America/Jamaica" | :"America/Jujuy" | :"America/Juneau" | :"America/Kentucky/Louisville" | :"America/Kentucky/Monticello" | :"America/Knox_IN" | :"America/Kralendijk" | :"America/La_Paz" | :"America/Lima" | :"America/Los_Angeles" | :"America/Louisville" | :"America/Lower_Princes" | :"America/Maceio" | :"America/Managua" | :"America/Manaus" | :"America/Marigot" | :"America/Martinique" | :"America/Matamoros" | :"America/Mazatlan" | :"America/Mendoza" | :"America/Menominee" | :"America/Merida" | :"America/Metlakatla" | :"America/Mexico_City" | :"America/Miquelon" | :"America/Moncton" | :"America/Monterrey" | :"America/Montevideo" | :"America/Montreal" | :"America/Montserrat" | :"America/Nassau" | :"America/New_York" | :"America/Nipigon" | :"America/Nome" | :"America/Noronha" | :"America/North_Dakota/Beulah" | :"America/North_Dakota/Center" | :"America/North_Dakota/New_Salem" | :"America/Nuuk" | :"America/Ojinaga" | :"America/Panama" | :"America/Pangnirtung" | :"America/Paramaribo" | :"America/Phoenix" | :"America/Port-au-Prince" | :"America/Port_of_Spain" | :"America/Porto_Acre" | :"America/Porto_Velho" | :"America/Puerto_Rico" | :"America/Punta_Arenas" | :"America/Rainy_River" | :"America/Rankin_Inlet" | :"America/Recife" | :"America/Regina" | :"America/Resolute" | :"America/Rio_Branco" | :"America/Rosario" | :"America/Santa_Isabel" | :"America/Santarem" | :"America/Santiago" | :"America/Santo_Domingo" | :"America/Sao_Paulo" | :"America/Scoresbysund" | :"America/Shiprock" | :"America/Sitka" | :"America/St_Barthelemy" | :"America/St_Johns" | :"America/St_Kitts" | :"America/St_Lucia" | :"America/St_Thomas" | :"America/St_Vincent" | :"America/Swift_Current" | :"America/Tegucigalpa" | :"America/Thule" | :"America/Thunder_Bay" | :"America/Tijuana" | :"America/Toronto" | :"America/Tortola" | :"America/Vancouver" | :"America/Virgin" | :"America/Whitehorse" | :"America/Winnipeg" | :"America/Yakutat" | :"America/Yellowknife" | :"Antarctica/Casey" | :"Antarctica/Davis" | :"Antarctica/DumontDUrville" | :"Antarctica/Macquarie" | :"Antarctica/Mawson" | :"Antarctica/McMurdo" | :"Antarctica/Palmer" | :"Antarctica/Rothera" | :"Antarctica/South_Pole" | :"Antarctica/Syowa" | :"Antarctica/Troll" | :"Antarctica/Vostok" | :"Arctic/Longyearbyen" | :"Asia/Aden" | :"Asia/Almaty" | :"Asia/Amman" | :"Asia/Anadyr" | :"Asia/Aqtau" | :"Asia/Aqtobe" | :"Asia/Ashgabat" | :"Asia/Ashkhabad" | :"Asia/Atyrau" | :"Asia/Baghdad" | :"Asia/Bahrain" | :"Asia/Baku" | :"Asia/Bangkok" | :"Asia/Barnaul" | :"Asia/Beirut" | :"Asia/Bishkek" | :"Asia/Brunei" | :"Asia/Calcutta" | :"Asia/Chita" | :"Asia/Choibalsan" | :"Asia/Chongqing" | :"Asia/Chungking" | :"Asia/Colombo" | :"Asia/Dacca" | :"Asia/Damascus" | :"Asia/Dhaka" | :"Asia/Dili" | :"Asia/Dubai" | :"Asia/Dushanbe" | :"Asia/Famagusta" | :"Asia/Gaza" | :"Asia/Harbin" | :"Asia/Hebron" | :"Asia/Ho_Chi_Minh" | :"Asia/Hong_Kong" | :"Asia/Hovd" | :"Asia/Irkutsk" | :"Asia/Istanbul" | :"Asia/Jakarta" | :"Asia/Jayapura" | :"Asia/Jerusalem" | :"Asia/Kabul" | :"Asia/Kamchatka" | :"Asia/Karachi" | :"Asia/Kashgar" | :"Asia/Kathmandu" | :"Asia/Katmandu" | :"Asia/Khandyga" | :"Asia/Kolkata" | :"Asia/Krasnoyarsk" | :"Asia/Kuala_Lumpur" | :"Asia/Kuching" | :"Asia/Kuwait" | :"Asia/Macao" | :"Asia/Macau" | :"Asia/Magadan" | :"Asia/Makassar" | :"Asia/Manila" | :"Asia/Muscat" | :"Asia/Nicosia" | :"Asia/Novokuznetsk" | :"Asia/Novosibirsk" | :"Asia/Omsk" | :"Asia/Oral" | :"Asia/Phnom_Penh" | :"Asia/Pontianak" | :"Asia/Pyongyang" | :"Asia/Qatar" | :"Asia/Qostanay" | :"Asia/Qyzylorda" | :"Asia/Rangoon" | :"Asia/Riyadh" | :"Asia/Saigon" | :"Asia/Sakhalin" | :"Asia/Samarkand" | :"Asia/Seoul" | :"Asia/Shanghai" | :"Asia/Singapore" | :"Asia/Srednekolymsk" | :"Asia/Taipei" | :"Asia/Tashkent" | :"Asia/Tbilisi" | :"Asia/Tehran" | :"Asia/Tel_Aviv" | :"Asia/Thimbu" | :"Asia/Thimphu" | :"Asia/Tokyo" | :"Asia/Tomsk" | :"Asia/Ujung_Pandang" | :"Asia/Ulaanbaatar" | :"Asia/Ulan_Bator" | :"Asia/Urumqi" | :"Asia/Ust-Nera" | :"Asia/Vientiane" | :"Asia/Vladivostok" | :"Asia/Yakutsk" | :"Asia/Yangon" | :"Asia/Yekaterinburg" | :"Asia/Yerevan" | :"Atlantic/Azores" | :"Atlantic/Bermuda" | :"Atlantic/Canary" | :"Atlantic/Cape_Verde" | :"Atlantic/Faeroe" | :"Atlantic/Faroe" | :"Atlantic/Jan_Mayen" | :"Atlantic/Madeira" | :"Atlantic/Reykjavik" | :"Atlantic/South_Georgia" | :"Atlantic/St_Helena" | :"Atlantic/Stanley" | :"Australia/ACT" | :"Australia/Adelaide" | :"Australia/Brisbane" | :"Australia/Broken_Hill" | :"Australia/Canberra" | :"Australia/Currie" | :"Australia/Darwin" | :"Australia/Eucla" | :"Australia/Hobart" | :"Australia/LHI" | :"Australia/Lindeman" | :"Australia/Lord_Howe" | :"Australia/Melbourne" | :"Australia/NSW" | :"Australia/North" | :"Australia/Perth" | :"Australia/Queensland" | :"Australia/South" | :"Australia/Sydney" | :"Australia/Tasmania" | :"Australia/Victoria" | :"Australia/West" | :"Australia/Yancowinna" | :"Brazil/Acre" | :"Brazil/DeNoronha" | :"Brazil/East" | :"Brazil/West" | :CET | :CST6CDT | :"Canada/Atlantic" | :"Canada/Central" | :"Canada/Eastern" | :"Canada/Mountain" | :"Canada/Newfoundland" | :"Canada/Pacific" | :"Canada/Saskatchewan" | :"Canada/Yukon" | :"Chile/Continental" | :"Chile/EasterIsland" | :Cuba | :EET | :EST | :EST5EDT | :Egypt | :Eire | :"Etc/GMT" | :"Etc/GMT+0" | :"Etc/GMT+1" | :"Etc/GMT+10" | :"Etc/GMT+11" | :"Etc/GMT+12" | :"Etc/GMT+2" | :"Etc/GMT+3" | :"Etc/GMT+4" | :"Etc/GMT+5" | :"Etc/GMT+6" | :"Etc/GMT+7" | :"Etc/GMT+8" | :"Etc/GMT+9" | :"Etc/GMT-0" | :"Etc/GMT-1" | :"Etc/GMT-10" | :"Etc/GMT-11" | :"Etc/GMT-12" | :"Etc/GMT-13" | :"Etc/GMT-14" | :"Etc/GMT-2" | :"Etc/GMT-3" | :"Etc/GMT-4" | :"Etc/GMT-5" | :"Etc/GMT-6" | :"Etc/GMT-7" | :"Etc/GMT-8" | :"Etc/GMT-9" | :"Etc/GMT0" | :"Etc/Greenwich" | :"Etc/UCT" | :"Etc/UTC" | :"Etc/Universal" | :"Etc/Zulu" | :"Europe/Amsterdam" | :"Europe/Andorra" | :"Europe/Astrakhan" | :"Europe/Athens" | :"Europe/Belfast" | :"Europe/Belgrade" | :"Europe/Berlin" | :"Europe/Bratislava" | :"Europe/Brussels" | :"Europe/Bucharest" | :"Europe/Budapest" | :"Europe/Busingen" | :"Europe/Chisinau" | :"Europe/Copenhagen" | :"Europe/Dublin" | :"Europe/Gibraltar" | :"Europe/Guernsey" | :"Europe/Helsinki" | :"Europe/Isle_of_Man" | :"Europe/Istanbul" | :"Europe/Jersey" | :"Europe/Kaliningrad" | :"Europe/Kiev" | :"Europe/Kirov" | :"Europe/Kyiv" | :"Europe/Lisbon" | :"Europe/Ljubljana" | :"Europe/London" | :"Europe/Luxembourg" | :"Europe/Madrid" | :"Europe/Malta" | :"Europe/Mariehamn" | :"Europe/Minsk" | :"Europe/Monaco" | :"Europe/Moscow" | :"Europe/Nicosia" | :"Europe/Oslo" | :"Europe/Paris" | :"Europe/Podgorica" | :"Europe/Prague" | :"Europe/Riga" | :"Europe/Rome" | :"Europe/Samara" | :"Europe/San_Marino" | :"Europe/Sarajevo" | :"Europe/Saratov" | :"Europe/Simferopol" | :"Europe/Skopje" | :"Europe/Sofia" | :"Europe/Stockholm" | :"Europe/Tallinn" | :"Europe/Tirane" | :"Europe/Tiraspol" | :"Europe/Ulyanovsk" | :"Europe/Uzhgorod" | :"Europe/Vaduz" | :"Europe/Vatican" | :"Europe/Vienna" | :"Europe/Vilnius" | :"Europe/Volgograd" | :"Europe/Warsaw" | :"Europe/Zagreb" | :"Europe/Zaporozhye" | :"Europe/Zurich" | :Factory | :GB | :"GB-Eire" | :GMT | :"GMT+0" | :"GMT-0" | :GMT0 | :Greenwich | :HST | :Hongkong | :Iceland | :"Indian/Antananarivo" | :"Indian/Chagos" | :"Indian/Christmas" | :"Indian/Cocos" | :"Indian/Comoro" | :"Indian/Kerguelen" | :"Indian/Mahe" | :"Indian/Maldives" | :"Indian/Mauritius" | :"Indian/Mayotte" | :"Indian/Reunion" | :Iran | :Israel | :Jamaica | :Japan | :Kwajalein | :Libya | :MET | :MST | :MST7MDT | :"Mexico/BajaNorte" | :"Mexico/BajaSur" | :"Mexico/General" | :NZ | :"NZ-CHAT" | :Navajo | :PRC | :PST8PDT | :"Pacific/Apia" | :"Pacific/Auckland" | :"Pacific/Bougainville" | :"Pacific/Chatham" | :"Pacific/Chuuk" | :"Pacific/Easter" | :"Pacific/Efate" | :"Pacific/Enderbury" | :"Pacific/Fakaofo" | :"Pacific/Fiji" | :"Pacific/Funafuti" | :"Pacific/Galapagos" | :"Pacific/Gambier" | :"Pacific/Guadalcanal" | :"Pacific/Guam" | :"Pacific/Honolulu" | :"Pacific/Johnston" | :"Pacific/Kanton" | :"Pacific/Kiritimati" | :"Pacific/Kosrae" | :"Pacific/Kwajalein" | :"Pacific/Majuro" | :"Pacific/Marquesas" | :"Pacific/Midway" | :"Pacific/Nauru" | :"Pacific/Niue" | :"Pacific/Norfolk" | :"Pacific/Noumea" | :"Pacific/Pago_Pago" | :"Pacific/Palau" | :"Pacific/Pitcairn" | :"Pacific/Pohnpei" | :"Pacific/Ponape" | :"Pacific/Port_Moresby" | :"Pacific/Rarotonga" | :"Pacific/Saipan" | :"Pacific/Samoa" | :"Pacific/Tahiti" | :"Pacific/Tarawa" | :"Pacific/Tongatapu" | :"Pacific/Truk" | :"Pacific/Wake" | :"Pacific/Wallis" | :"Pacific/Yap" | :Poland | :Portugal | :ROC | :ROK | :Singapore | :Turkey | :UCT | :"US/Alaska" | :"US/Aleutian" | :"US/Arizona" | :"US/Central" | :"US/East-Indiana" | :"US/Eastern" | :"US/Hawaii" | :"US/Indiana-Starke" | :"US/Michigan" | :"US/Mountain" | :"US/Pacific" | :"US/Pacific-New" | :"US/Samoa" | :UTC | :Universal | :"W-SU" | :WET | :Zulu }
Parameters specifying how the report should be run. Different Report Types have different required and optional parameters, listed in the API Access to Reports documentation.
@type t() :: %Stripe.Reporting.ReportRun{ created: integer(), error: binary() | nil, id: binary(), livemode: boolean(), object: binary(), parameters: term(), report_type: binary(), result: Stripe.File.t() | nil, status: binary(), succeeded_at: integer() | nil }
The reporting.report_run
type.
created
Time at which the object was created. Measured in seconds since the Unix epoch.error
If something should go wrong during the run, a message about the failure (populated whenstatus=failed
).id
Unique identifier for the object.livemode
true
if the report is run on live mode data andfalse
if it is run on test mode data.object
String representing the object's type. Objects of the same type share the same value.parameters
report_type
The ID of the report type to run, such as"balance.summary.1"
.result
The file object representing the result of the report run (populated whenstatus=succeeded
).status
Status of this report run. This will bepending
when the run is initially created. When the run finishes, this will be set tosucceeded
and theresult
field will be populated. Rarely, we may encounter an error, at which point this will be set tofailed
and theerror
field will be populated.succeeded_at
Timestamp at which this run successfully finished (populated whenstatus=succeeded
). Measured in seconds since the Unix epoch.
Functions
@spec create( params :: %{ optional(:expand) => [binary()], optional(:parameters) => parameters(), optional(:report_type) => binary() }, opts :: Keyword.t() ) :: {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Creates a new object and begin running the report. (Certain report types require a live-mode API key.)
Details
- Method:
post
- Path:
/v1/reporting/report_runs
@spec list( params :: %{ optional(:created) => created() | integer(), optional(:ending_before) => binary(), optional(:expand) => [binary()], optional(:limit) => integer(), optional(:starting_after) => binary() }, opts :: Keyword.t() ) :: {:ok, Stripe.List.t(t())} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Returns a list of Report Runs, with the most recent appearing first.
Details
- Method:
get
- Path:
/v1/reporting/report_runs
@spec retrieve( report_run :: binary(), params :: %{optional(:expand) => [binary()]}, opts :: Keyword.t() ) :: {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}
Retrieves the details of an existing Report Run.
Details
- Method:
get
- Path:
/v1/reporting/report_runs/{report_run}