Retrieve an Activities Export

GET https://api.chartmogul.com/v1/activities_export/

Returns an activities report with a list of activities for the specified time period.

curl -X GET "https://api.chartmogul.com/v1/activities_export/17042239-3674-4a61-b838-b6b307f28506" \
     -u YOUR_API KEY:

# Available from chartmogul-ruby >= 2.0.0

ChartMogul::Metrics::ActivitiesExport.retrieve("17042239-3674-4a61-b838-b6b307f28506")

ChartMogul.Metrics.ActivitiesExport.retrieve(
  config,
  "17042239-3674-4a61-b838-b6b307f28506"
);

ChartMogul\Metrics\ActivitiesExport::retrieve("17042239-3674-4a61-b838-b6b307f28506");

api.MetricsRetrieveActivitiesExport("17042239-3674-4a61-b838-b6b307f28506")

chartmogul.ActivitiesExport.retrieve(config, id="17042239-3674-4a61-b838-b6b307f28506")

{
  "id": "17042239-3674-4a61-b838-b6b307f28506",
  "status": "succeeded",
  "file_url": "https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip",
  "params": {
    "kind": "activities",
    "params": {
      "end_date": "2022-12-31 00:00:00 +0000",
      "start_date": "2022-01-01 00:00:00 +0000",
      "activity_type": "new_biz"
    }
  },
  "expires_at": "2023-07-16T14:37:43+00:00",
  "created_at": "2023-07-09T14:37:32+00:00"
}

#<ChartMogul::Metrics::ActivitiesExport:0x00007f8efa397570
  @created_at="2023-07-09T14:37:32+00:00",
  @expires_at="2023-07-16T14:37:43+00:00",
  @file_url=
  "https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip",
  @id="17042239-3674-4a61-b838-b6b307f28506",
  @params={
    :kind=>"activities", 
    :params=>{
      :end_date=>"2022-12-31 00:00:00 +0000", 
      :start_date=>"2022-01-01 00:00:00 +0000", 
      :activity_type=>"new_biz"
    }
  },
  @status="succeeded"
>

{
  id: "17042239-3674-4a61-b838-b6b307f28506",
  status: "succeeded",
  file_url: "https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip",
  params: {
    kind: "activities",
    params: {
      end_date: "2022-12-31 00:00:00 +0000",
      start_date: "2022-01-01 00:00:00 +0000",
      activity_type: "new_biz"
    }
  },
  expires_at: "2023-07-16T14:37:43+00:00",
  created_at: "2023-07-09T14:37:32+00:00"
}

class ChartMogul\Metrics\ActivitiesExport#8027 (10) {
  protected $id => string(36) "17042239-3674-4a61-b838-b6b307f28506"
  protected $status => string(9) "succeeded"
  protected $file_url => string(123) "https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip"
  protected $params => array(2) {
    "kind" => string(10) "activities"
    "params" => array(3) {
      "activity_type" => string(11) "new_biz"
      "start_date" => string(10) "2022-01-01"
      "end_date" => string(10) "2022-12-31"
    }
  }
  protected $expires_at => string(25) "2023-07-16T14:37:43+00:00"
  protected $created_at => string(25) "2023-07-09T14:37:32+00:00"
}

(*chartmogul.MetricsActivitiesExport)(0xc0000acc60)({
  ID: (string) (len=36) "17042239-3674-4a61-b838-b6b307f28506",
  Status: (string) (len=9) "succeeded",
  FileURL: (string) (len=123) "https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip",
  Params: (chartmogul.Params) {
   Kind: (string) (len=10) "activities",
   Params: (chartmogul.NestedParams) {
    ActivityType: (string) (len=11) "new_biz",
    StartDate: (string) (len=10) "2022-01-01",
    EndDate: (string) (len=10) "2022-12-31"
   }
  },
  ExpiresAt: (string) (len=25) "2023-07-16T14:37:43+00:00",
  CreatedAt: (string) (len=25) "2023-07-09T14:37:32+00:00"
})

<ActivitiesExport{
  created_at=datetime.datetime(2023, 7, 9, 14, 37, 32, tzinfo=datetime.timezone(datetime.timedelta(0), "+0000")), 
  expires_at=datetime.datetime(2023, 7, 16, 14, 37, 32, tzinfo=datetime.timezone(datetime.timedelta(0), "+0000")), 
  file_url="https://chartmogul-customer-export.s3.eu-west-1.amazonaws.com/activities-acme-corp-062ea48c-5d74-46dd-bd60-23206cdc241a.zip", 
  id="17042239-3674-4a61-b838-b6b307f28506",
   params={"kind": "activities", "params": {}}, 
   status="succeeded"
}>

Path parameters

id string required: ID of the activities export

Body parameters

start-date string: Activities whose date is greater than or equal to this value will be returned. Must be an ISO 8601 formatted time. The timezone defaults to UTC unless otherwise specified. The time defaults to 00:00:00 unless specified otherwise.
end-date string: Activities whose date is lesser than or equal to this value will be returned. Must be an ISO 8601 formatted time. The timezone defaults to UTC unless otherwise specified. The time defaults to 00:00:00 unless specified otherwise.
type string: You can use this to request activities of a particular type. Value should be one of new_biz, reactivation, expansion, contraction or churn. If param is not present, all types will be returned.

Response

The response contains the following data:

id: This is the ID of the activities export.
status: Initially, this will be pending and then move to processing followed by failed or succeeded.
file_url: Initially this will be null. Upon successful status, it will be populated with a URL to the zipped export.
params: This provides details on the requested export, as submitted by you in the body of the POST request.
expires_at: Initially this will be null. Once the file_url is populated, it will state the timestamp at which the file_url will expire.
created_at: This is a timestamp.