Scheduled Log Exports API Overview

Overview

Branch's Scheduled Log Exports API lets you schedule daily or hourly exports of log-level data from Branch.

These results are made available to you in one of three ways:

The data is stored in Branch's AWS S3 bucket
The data is delivered to your own cloud storage account (AWS or GCP)
The data is delivered to you via email

You can stay on top of monitoring the data by creating a subscription to a particular feed. A subscription is a single report (which includes information such as data source, fields, and filters) that is set up to be exported over and over at a regular cadence.

A job represents one time that the report was run and data was exported. The result is one or more files with exported data. Depending on the cadence, a job results in exporting data for either one hour or one day.

Packaging

Access to the Scheduled Log Exports API requires our Advanced Data Feeds add-on.

The Advanced Data Feeds add-on also includes access to:

The Cross-Events Export API.
- Unified Analytics Export
Data integrations for exports.
Webhook functionality.

Learn more on our packaging page.

Benefits

With the Scheduled Log Exports API, your log-level data can be funneled to a number of different places, and new data is made available to you on a daily cadence.

Use Cases

Automate Branch log-level data retrieval based on a schedule (hourly or daily), selecting your own data fields and filters.
Set up notifications on sudden day-over-day increases/decreases in attributed installs.
Export your data directly to your cloud account. There is no need to manually request exports - instead, your data goes directly to your cloud storage where you can access it at any time.
Set up regular exports to agencies with the ability to hide certain data from partners to protect privacy, increasing your control over your data.
Set up recurring emails with custom reports to share agency-attributed installs with your agency via email. Also share ad network postback records with your ad network.

Limits

Limit	Details
Subscriptions	35 subscriptions If you need to generate more than 35 reports, you should start by exporting all of the data you need for a particular event in one subscription. Then, split that data into multiple reports from within your data warehouse. Please note that Branch currently has fewer than 30 events (called "eo topics") available for export.
Cadence	Data is exported on a daily or hourly cadence. For data that is exported on a daily cadence, the 24 hours of data from the previous day will be ready roughly 6 hours into a new UTC day (usually sooner). For data that is exported on an hourly cadence, the data for the previous hour will be ready roughly 6 hours later (usually sooner).

Getting Started

Prerequisites

In order to use the Scheduled Log Exports API, you first need to:

Create a Branch Dashboard.
Make sure you have the appropriate permissions set on your account. See the "Access" section for more.

Cloud Storage

If you want to store your Scheduled Log Exports API data in your own cloud storage account (AWS or GCP), you will need to:

Retrieve your external ID from Branch by using this API's /scheduled-exports/logs/subscription/externalId endpoint.
Follow our cloud set up guide to properly configure your AWS or GCP account to receive data from Branch.
Use this API's /scheduled-exports/logs/subscribe endpoint to create a new subscription that points the data to your cloud storage account.

Access

Access to the Scheduled Log Exports API requires our Advanced Data Feeds add-on.

Learn more on our pricing page.

General Access

To access the Scheduled Log Exports API, a user must have both Aggregate Data and Export access enabled on their account.

Agency Access

If you work with an agency that runs your advertising campaigns and want to give them access to export the subsequent data, you can give them Export and Aggregate Data access.

To provide an agency team member with access to the Scheduled Log Exports:

In the left-hand navigation, under Setup & Testing, click on Account Settings.
On the Account Settings page, click on the Agencies tab.
Expand the agency in question, find the agency team member you want to give access to, hover on the button in the Actions column, and click Edit.
In the Edit Agency Team Member modal:
1. Under Access Level, check the Export box.
2. Under Permissions, check the Aggregate Data box.
Optional: add data filters
1. Under Data Filters, toggle any necessary data filters on/blue. Exported data will be filtered accordingly.
Click Save.

1246

Authentication

Calls to the Scheduled Log Exports API require an api_key and app_id query string parameters to be passed with each request.

Important notes about your API key:

API keys are generated on a per-user basis and are permanent.
In order to retrieve or reset your API key/access token, you must have Organizational Level access to the Branch account. This functionality is not present at the App Level.
If the api_key being used is deleted or permissions are removed, the scheduled export will no longer work and will be deactivated.
You must use the same api_key that was used to create the schedule originally in order to retrieve information regarding the subscription and the exports generated.

Learn how to retrieve your API key (also known as access_token) in our guide.

Usage

Get External ID

Branch provides a unique external ID for your Branch account.

This external ID can be used when setting up data to be exported to your own cloud service.

Your external ID is not relevant if you are accessing data via Branch's cloud or email.

Request Info

Endpoint

GET /scheduled-exports/logs/subscription/externalId?{app_id|organization_id}={id}

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Request Query Parameters

Provide one of the following two options:

Parameter	Description	Required
`app_id`	The app ID with which the Access Token and subscriptions are associated.	Required if `organization_id` is not present
`organization_id`	The organization ID with which the Access Token and subscriptions are associated.	Required if `app_id` is not present

Response Info

Response Body Parameters

Parameter	Description
`external_id`	The external ID associated with your Branch account. For AWS, this external ID can be used in the Trust Relationship for the Role that you create to allow Branch to access your S3 bucket.

Example Request & Response

Request (cURL)

Response (JSON)

# Include either app_id or organization_id in request query

curl -H 'access-token: api_app_99999999999999999999999999999999' \
  'https://api2.branch.io/scheduled-exports/logs/subscription/externalId?app_id=123456789009876543'

{"external_id":"111111bbbb-bbb111-1b1b1b1-1111-bbb"}

Create New Subscription

This type of request sets up a new scheduled log export subscription. This is supported at both the app and org level.

The result of this request is a subscription that specifies what data will be exported and where that data will be exported to.

Duplicate Subscriptions
In order to prevent duplicate active subscriptions from being created accidentally, Branch will throw an error if you attempt to create a subscription that exactly matches an existing subscription.
This is based on the following values:
subscription_type
report_type
app_id or organization_id
fields
filter
cadence
However, simply re-ordering the values in fields is enough to bypass this check and create a new subscription.

Request Info

Endpoint

POST /scheduled-exports/logs/subscribe

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Required
`accept`	application/json	Recommended

Request Body Parameters

Parameter	Description	Required
`report`	An object describing the report to be generated.	Required
`report.cadence`	How frequently to generate the report, and for what time period. Options: - `Daily` - `Hourly`	Required
`report.response_format`	Format that the report is delivered in. Options: - `csv` - `json` - `parquet`	Required
`report.response_format_compression`	The file compression method to use for the data. Default: `gz` Options: - `gz` - `snappy`	No
`response.report_type`	The topic to subscribe to for log-level data, also called the "eo topic". This is the data source from which data should be exported. See the "Available Topics" section for a list of topics to choose from.	Required
`report.report_fields`	The fields related to the topic that should be exported. These fields will be represented by columns in the CSV file. See the "Available Fields" section for a list of fields to choose from.	Required
`report.filter`	Filter used to limit which data points should be exported. These data points will be represented by rows in the CSV file. Learn more in the "Cthulhu Filter Specification" section.	No
`destination`	An object containing information about where a finished report should be stored and how it can be accessed.	Required
`destination.subscription_type`	Options: - `branch` (to send the data to Branch's AWS S3 bucket) - `cloud` (to send the data to your own cloud) - `email` (to receive a daily email with the data)Learn more about sending data to your own cloud storage account in Branch's cloud setup guide.	Required
`destination.cloud`	If you set `destination.subscription_type` to `cloud`, set this parameter to the cloud provider want to use to store Branch data. Options: - `s3` (AWS S3) - `gcs`(Google Cloud Storage)	Required if `subscription_type` is set to `cloud`
`destination.resource_access_id`	The ID for the resource you own, which you are using to store Branch data. AWS: The ARN for the AWS Role. GCP: The full service account name, which looks like an email address, for example: `[email protected]`.	Required if `subscription_type` is set to `cloud`
`destination.bucket`	The name of the bucket you own, which you are using to store Branch data.	Required if `subscription_type` is set to `cloud` and you want to store Branch data in a bucket
`destination.prefix`	The prefix or folder you own, which you are using to store Branch data. AWS: For the path `s3://my-branch-export-bucket/my-folder/`, this would be `my-folder`. GCP: For the path `/buckets/my-branch-bucket/objects/branch/important_reports/` this would be `branch/important_reports`.	Required if `subscription_type` is set to `cloud` and you want to store Branch data in a folder

Response Info

Response Body Parameters

Parameter	Description
`subscription_id`	The persistent ID created for and assigned to this subscription. This ID is used to check the status of a subscription, locate recent export jobs, and make modifications.
`status`	The status of the newly created subscription. A subscription in the `"ACTIVE"` state means the subscription was set up successfully. The `"PENDING"` state means that Branch is still testing the setup of the subscription. Branch does this by creating an initial test report to make sure the export works properly. If the subscription is in the `"FAILED"` state, this means the test export was unsuccessful.
`description`	More information about the `status` of the subscription.
`subscription_url`	Use this URL in the future to get details about this particular subscription. See the "Get Details on Individual Subscription" section for more.

Examples

Example Requests

The examples below demonstrate how to create a new subscription and make your data accessible in one of three ways: Branch's S3 storage, your own cloud storage, or a daily email.

Request (cURL)

#  Example Request: Store Data in Your Own Cloud

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' \
-H 'access-token: api_app_99999999999999999999999999999999' -d '{
  "report": {
    "cadence": "hourly",
    "response_format": "csv",
    "response_format_compression": "gz",
    "report_type": "eo_install",
    "report_fields": [
      "id",
      "timestamp",
      "user_data_os",
      "user_data_idfa",
      "user_data_aaid",
      "user_data_idfv"
    ],
    "filter": [
      "eq",
      "attributed",
      "true"
    ]
  },
  "destination": {
    "subscription_type": "cloud",
    "cloud": "s3",
    "resource_access_id": "arn:aws:iam::xxxxxxxxxxxx:role/Branch-Export-Upload-tbd",
    "bucket": "my-branch-export-bucket",
    "prefix": "my-folder"
  }
}' 'https://api2.branch.io/scheduled-exports/logs/subscribe?app_id=123456789009876543'

#  Example Request: Store Data in Branch's S3 Bucket

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' \
-H 'access-token: api_app_99999999999999999999999999999999' -d '{
  "report": {
    "cadence": "hourly",
    "response_format": "csv",
    "response_format_compression": "gz",
    "report_type": "eo_install",
    "report_fields": [
      "id",
      "timestamp",
      "user_data_os",
      "user_data_idfa",
      "user_data_idfv",
      "user_data_aaid"
    ],
    "filter": [
      "eq",
      "attributed",
      "true"
    ]
  },
  "destination": {
    "subscription_type": "branch"
  }
}' 'https://api2.branch.io/scheduled-exports/logs/subscribe?app_id=123456789009876543'

# Example Request: Receive a Daily Email

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' \
-H 'access-token: api_app_99999999999999999999999999999999' -d '{
  "report": {
    "cadence": "hourly",
    "response_format": "csv",
    "response_format_compression": "gz",
    "report_type": "eo_install",
    "report_fields": [
      "id",
      "timestamp",
      "user_data_os",
      "user_data_idfa",
      "user_data_idfv",
      "user_data_aaid"
    ],
    "filter": [
      "eq",
      "attributed",
      "true"
    ]
  },
  "destination": {
    "subscription_type": "email",
    "recipient_emails": [ "[email protected]" ]
  }
}' 'https://api2.branch.io/scheduled-exports/logs/subscribe?app_id=123456789009876543'

Example Generic Response

{
  "subscription_id": "0000aaaa-00-0a0a-0000",
  "status": "PENDING",
  "description": "Generating sample report. Subscription will finish after Report is uploaded",
  "subscription_url": "https://api2.branch.io/scheduled-exports/exports/logs/subscription/0000aaaa-00-0a0a-0000?app_id=123456789009876543"
}

Deactivate Subscription

Request Info

Endpoint

DELETE /scheduled-exports/logs/subscription/{subscription_id}?{app_id|organization_id}={id}

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Request Query Parameters

Parameter	Description	Required
`subscription_id`	The `subscription_id` for the subscription you want to deactivate. You can only deactivate one subscription at a time.	Required
`app_id`	The app ID with which the Access Token is associated.	Required if `organization_id` is not present
`organization_id`	The organization ID with which the Access Token is associated.	Required if `app_id` is not present

Response Info

Response Body Parameters

Parameter	Description
`status`	Whether your deactivation request was successful.
`description`	Additional information about the status of your request.

Example Request & Response

Request (cURL)

Response (JSON)

# Include either `app_id` or `organization_id` in request query

curl -X DELETE -H 'access-token: api_app_99999999999999999999999999999999' \
  'https://api2.branch.io/scheduled-exports/logs/subscription/0000aaaa-00-0a0a-0000?app_id=123456789009876543'

{
  "status": "SUCCESS",
  "description": "Subscription deactivated successfully"
}

Get Details on Single Subscription

Returns a single export subscription for a given subscription ID.

See what data is being exported and where data is exported to (Branch's cloud, your own cloud, or email).

Request Info

Endpoint

GET /scheduled-exports/logs/subscription/{subscription_id}?{app_id|organization_id}={id}

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Request Query Parameters

Parameter	Description	Required
`subscription_id`	The relevant subscription ID.	Required
`app_id`	The app ID with which the Access Token is associated.	Required if `organization_id` is not present
`organization_id`	The organization ID with which the Access Token is associated.	Required if `app_id` is not present

Response Info

Response Body Parameters

Parameter	Description
`subscription_id`	The persistent ID created for and assigned to this subscription.
`report`	An object describing the report to be generated.
`report.cadence`	How frequently to generate the report, and for what time period. Options: - Daily - Hourly
`report.response_format`	Format that the report is delivered in. Options: - csv - json - parquet
`report.response_format_compression`	The file compression method to use for the data. Default: gz Options: - gz - snappy
`response.report_type`	The topic to subscribe to for log-level data, also called the "eo topic". This is the data source from which data should be exported. See the "Available Topics" section for a list of topics to choose from.
`report.report_fields`	The fields related to the topic that should be exported. These fields will be represented by columns in the CSV file. See the "Available Fields" section for a list of fields to choose from.
`report.filter`	Filter used to limit which data points should be exported. These data points will be represented by rows in the CSV file. Learn more in the "Cthulhu Filter Specification" section.
`report.subscription_status`	The current status of this subscription.
`destination`	An object containing information about where a finished report should be stored and how it can be accessed.
`destination.subscription_type`	Where the finished report is stored and how it can be accessed. Options: - `branch` (data sent to Branch's AWS S3 bucket) - `cloud` (data sent to your own cloud) - `email` (data sent via a daily email)
`destination.cloud`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the cloud service you are using to store Branch data.
`destination.resource_access_id`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the ID for the resource you are using to store Branch data.
`destination.bucket`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the name of the bucket you are using to store Branch data.
`destination.prefix`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the prefix or folder you are using to store Branch data.

Example Request & Response

Request (cURL)

Response (JSON)

# Include either `app_id` or `organization_id` in request query

curl -H 'access-token: api_app_99999999999999999999999999999999' \
  'https://api2.branch.io/scheduled-exports/logs/subscription/0000aaaa-00-0a0a-0000?app_id=123456789009876543'

{
  "subscription_id": "0000aaaa-00-0a0a-0000",
  "report": {
    "cadence": "hourly",
    "filter": [
      "eq",
      "attributed",
      "true"
    ],
    "response_format": "csv",
    "response_format_compression": "gz",
    "report_type": "eo_install",
    "report_fields": [
      "id",
      "timestamp",
      "user_data_os",
      "user_data_idfa",
      "user_data_idfv",
      "user_data_aaid"
    ],
    "subscription_status": "ACTIVE"
  },
  "destination": {
    "cloud": null,
    "bucket": null,
    "prefix": null,
    "subscription_type": "branch",
    "resource_access_id": null
  }
}

Get Details on All Subscriptions

Returns all export subscriptions for a given app or organization ID.

See what data is being exported and where data is exported to (Branch's cloud, your own cloud, or email).

Request Info

Endpoint

GET /scheduled-exports/logs/subscriptions?[app_id|organization_id]={id}

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Request Query Parameters

Provide one of the following two options:

Parameter	Description	Required
`app_id`	The app ID with which the Access Token and subscriptions are associated.	Required if `organization_id` is not present
`organization_id`	The organization ID with which the Access Token and subscriptions are associated.	Required if `app_id` is not present

Response Info

Response Body Parameters

An array of subscriptions is returned.

For each unique subscription, the following fields are returned:

Parameter	Description
`subscription_id`	The persistent ID created for and assigned to this subscription.
`report`	An object describing the report to be generated.
`report.cadence`	How frequently to generate the report, and for what time period. Options: - Daily - Hourly
`report.response_format`	Format that the report is delivered in. Options: - csv - json - parquet
`report.response_format_compression`	The file compression method to use for the data. Default: gz Options: - gz - snappy
`response.report_type`	The topic to subscribe to for log-level data, also called the "eo topic". This is the data source from which data should be exported. See the "Available Topics" section for a list of topics to choose from.
`report.report_fields`	The fields related to the topic that should be exported. These fields will be represented by columns in the CSV file. See the "Available Fields" section for a list of fields to choose from.
`report.filter`	Filter used to limit which data points should be exported. These data points will be represented by rows in the CSV file. Learn more in the "Cthulhu Filter Specification" section.
`report.subscription_status`	The current status of this subscription.
`destination`	An object containing information about where a finished report should be stored and how it can be accessed.
`destination.subscription_type`	Where the finished report is stored and how it can be accessed. Options: - `branch` (data sent to Branch's AWS S3 bucket) - `cloud` (data sent to your own cloud) - `email` (data sent via a daily email)
`destination.cloud`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the cloud service you are using to store Branch data.
`destination.resource_access_id`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the ID for the resource you are using to store Branch data.
`destination.bucket`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the name of the bucket you are using to store Branch data.
`destination.prefix`	If `destination.subscription_type` is `cloud`, this parameter will be populated with the prefix or folder you are using to store Branch data.

Example Request & Response

Request (cURL)

Response (JSON)

curl -H 'access-token: api_app_99999999999999999999999999999999' \
  'https://api2.branch.io/scheduled-exports/logs/subscriptions?app_id=123456789009876543'

[
  {
    "subscription_id": "0000aaaa-00-0a0a-0000",
    "report": {
      "cadence": "hourly",
      "filter": [
        "eq",
        "attributed",
        "true"
      ],
      "response_format": "csv",
      "response_format_compression": "gz",
      "report_type": "eo_install",
      "report_fields": [
        "id",
        "timestamp",
        "user_data_os",
        "user_data_idfa",
        "user_data_idfv",
        "user_data_aaid"
      ],
      "subscription_status": "ACTIVE"
    },
    "destination": {
      "cloud": null,
      "bucket": null,
      "prefix": null,
      "subscription_type": "branch",
      "resource_access_id": null
    }
  },
	{
    "subscription_id": "222cc2-ccc-22c-2222",
    "report": {
      "cadence": "daily",
      "filter": [
        "eq",
        "attributed",
        "true"
      ],
      "response_format": "csv",
      "response_format_compression": "gz",
      "report_type": "eo_install",
      "report_fields": [
        "id",
        "timestamp",
        "user_data_os",
        "user_data_idfa",
        "user_data_idfv",
        "user_data_aaid"
      ],
      "subscription_status": "ACTIVE"
    },
    "destination": {
      "cloud": "s3",
      "bucket": "my-branch-export-bucket",
      "prefix": "my-folder",
      "subscription_type": "cloud",
      "resource_access_id": "arn:aws:iam::xxxxxxxxxxxx:role/Branch-Export-Upload-tbd"
    }
  }
]

Get Details on Single Export Job

Scheduled exports run at a regular cadence. Each individual run is considered a "job" and has a "job ID".

You can get details on an individual job via this endpoint, as long as you know the subscription_id and the job_id. This includes where data was exported to (Branch's cloud, your own cloud, or email).

If you do not know the job_id and are instead trying to discover jobs associated with a particular subscription, see the "Get Details on Many Export Jobs" section.

Request Info

Endpoint

GET /scheduled-exports/logs/subscription/{subscription_id}/job/{job_id}

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Response Path Parameters

Parameter	Description
`subscription_id`	The relevant subscription ID.
`job_id`	The persistent identifier for this export job run.

Request Query Parameters

Provide one of the following two options:

Parameter	Description	Required
`app_id`	The app ID with which the Access Token and subscriptions are associated.	Required if `organization_id` is not present
`organization_id`	The organization ID with which the Access Token and subscriptions are associated.	Required if `app_id` is not present

Response Info

Response Body Parameters

Parameter	Description
`job_id`	The persistent identifier for this export job run.
`status`	The state that the job is in. Options: `PENDING_GENERATION` `PENDING_UPLOAD` `RUNNING` `SUCCEEDED` `FAILED`
`start_date`	The earliest date for which exported objects will be included. Timezone is UTC. Format: `yyyy-MM-dd'T'HH:mm:ssZ`
`end_date`	The latest date for which exported objects will be included. Timezone is UTC. Format: `"yyyy-MM-dd'T'HH:mm:ssZ"` Note: This value includes data through the final millisecond. So if `end_date` is `2021-09-30T19:59:59`, this export job run will include data through `2021-09-30T19:59:59.999`.
`export_url`	If the export job is for a subscription where `destination.subscription_type` is set to `branch`, then this will be an array of pre-signed S3 URLs for export files that you can download.
`lines_exported`	Number of objects in the export (i.e., CSV rows).

Example Request & Response

Request (cURL)

Response (JSON)

curl -H 'access-token: api_app_99999999999999999999999999999999' \
  'https://api2.branch.io/scheduled-exports/logs/subscription/0000aaaa-00-0a0a-0000/job/185c97bb-f928-4f0a-b295-63f2a087780e?app_id=123456789009876543'

{
  "job_id": "185c97bb-f928-4f0a-b295-63f2a087780e",
  "status": "SUCCEEDED",
  "start_date": "2021-09-16T01:00:00",
  "end_date": "2021-09-16T01:59:59",
  "export_url": [
    "https://branch-exports-web.s3.us-west-1.amazonaws.com/v2/y%3D2021/m%3D09/d%3D16/app_id%3D123456789009876543/job_id%3D185c97bb-f928-4f0a-b295-63f2a087780e/task_id%3D0/123456789009876543-2021-09-16-eo_install-v2-7b7b72ee4e1a68a1ab57b626d3bc3701f0f39f4b976141fc5fcadf83e5ba5605-FSQEXZ-0.csv.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210916T023737Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIA3HUFQARV3GLL7FKD%2F20210916%2Fus-west-1%2Fs3%2Faws4_request&X-Amz-Signature=19ad618f5c8a13bdf072925f664699c522b525187a968fb33442cb4abc915680"
  ],
  "lines_exported": 43
}

Get Details on Many Export Jobs

Scheduled exports run at a regular cadence. Each individual run is considered a "job" and has a "job ID".

You can get details on all recent export jobs for the subscription. This includes where data was exported to (Branch's cloud, your own cloud, or email).

Request Info

Endpoint

GET /scheduled-exports/logs/subscription/{subscription_id}/jobs

Request Headers

Header	Description	Required
`access-token`	Key that encapsulates the user's permission with regards to an organization. Obtained from the Branch Dashboard. Needed for authentication.	Required
`content-type`	application/json	Recommended
`accept`	application/json	Recommended

Request Path Parameters

Parameter	Description
`subscription_id`	The relevant subscription ID.

Request Query Parameters

Parameter	Description
`start_date`	The earliest date of export job runs to be included. Timezone is UTC. Format: `yyyy-MM-dd'T'HH:mm:ssZ`
`end_date`	Latest date of export job runs to be included. Timezone is UTC. Format: `"yyyy-MM-dd'T'HH:mm:ssZ"`

Response Body Parameters

An array of jobs is returned.

For each unique job, the following fields are returned:

Parameter	Description
`job_id`	The persistent identifier for this export job run.
`status`	The state that the job is in. Options: `PENDING_GENERATION` `PENDING_UPLOAD` `RUNNING` `SUCCEEDED` `FAILED`
`start_date`	The earliest date for which exported objects will be included. Timezone is UTC. Format: `yyyy-MM-dd'T'HH:mm:ssZ`
`end_date`	The latest date for which exported objects will be included. Timezone is UTC. Format: `"yyyy-MM-dd'T'HH:mm:ssZ"` Note: This value includes data through the final millisecond. So if `end_date` is `2021-09-30T19:59:59`, this export job run will include data through `2021-09-30T19:59:59.999`.
`export_url`	If the export job is for a subscription where `destination.subscription_type` is set to `branch`, then this will be an array of pre-signed S3 URLs for export files that you can download.
`lines_exported`	Number of objects in the export (i.e., CSV rows).

Example Request & Response

Request (cURL)

Response (JSON)

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' \
-H 'access-token: api_app_99999999999999999999999999999999' -d '{
"start_date": "2021-08-16T02:00:00"
"end_date": "2021-08-16T02:59:59"
}'https://api2.branch.io/scheduled-exports/logs/subscription/13dbe05c-175b-11ec-9621-0242ac130002?app_id=123456789009876543'

{
  "job_id": "185c97bb-f928-4f0a-b295-63f2a087780e",
  "status": "SUCCEEDED",
  "start_date": "2021-09-16T01:00:00",
  "end_date": "2021-09-16T01:59:59",
  "export_url": [
    "https://branch-exports-web.s3.us-west-1.amazonaws.com/v2/y%3D2021/m%3D09/d%3D16/app_id%3D123456789009876543/job_id%3D185c97bb-f928-4f0a-b295-63f2a087780e/task_id%3D0/123456789009876543-2021-09-16-eo_install-v2-xxxxxxxx-FSQEXZ-0.csv.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210916T023737Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIA3HUFQARV3GLL7FKD%xxxxxxxx%2Fus-west-1%2Fs3%2Faws4_request&X-Amz-Signature=xxxxxxxxxxxxxxxxxx"
  ],
  "job_id": "225c97bb-f348-3c0a-d545-88c2b093710f",
  "status": "SUCCEEDED",
  "start_date": "2021-08-16T02:00:00",
  "end_date": "2021-08-16T02:59:59",
  "export_url": [
    "https://branch-exports-web.s3.us-west-1.amazonaws.com/v2/y%4D2021/m%4D09/d%4D16/app_id%4D123456789009876543/job_id%4D185c97bb-f928-4f0a-c295-63f2a087780e/task_id%4D0/223456789009876543-2021-09-16-eo_install-v2-xxxxxxxx-FSQEXZ-2.csv.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210916T023737Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIA3HUFQARV3GLL7FKD%xxxxxxxx%2Fus-west-1%2Fs3%2Faws4_request&X-Amz-Signature=xxxxxxxxxxxxxxxxxx"
  ],  
  "lines_exported": 86
}

Appendix

Testing and Best Practices

Test Export and Cadence

Set up the subscription
1. Ensure that report.subscription_status field is set to ACTIVE
2. Branch recommends setting report.cadence to hourly so you can validate the export sooner
Wait for a test export run to complete and confirm the data looks as expected

Subscription Status Pending

If you check the report.subscription_status and it is in the PENDING state, wait a few minutes and try again. You should see it update to ACTIVE.

Querying Exported Data

Once the value of report.subscription_status is ACTIVE, Branch recommends searching through a full day's worth of data initially (set via the start_date and end_date parameters), then narrowing down after that if you plan to export data one hour at a time.

Available Topics

Topic	Human Readable Name
`eo_click_blocked`	Blocked Clicks
`eo_commerce_event_blocked`	Blocked Commerce Events
`eo_content_event_blocked`	Blocked Content Events
`eo_branch_cta_view_blocked`	Blocked CTA Views
`eo_custom_event_blocked`	Blocked Custom Events
`eo_impression_blocked`	Blocked Impressions
`eo_install_blocked`	Blocked Installs
`eo_open_blocked`	Blocked Opens
`eo_pageview_blocked`	Blocked Pageviews
`eo_reinstall_blocked`	Blocked Reinstalls
`eo_sms_sent_blocked`	Blocked SMS Sent
`eo_user_lifecycle_event_blocked`	Blocked User Lifecycle Events
`eo_web_session_start_blocked`	Blocked Web Session Starts
`eo_click`	Clicks
`eo_commerce_event`	Commerce Events
`eo_content_event`	Content Events
`eo_branch_cta_view`	CTA Views
`eo_custom_event`	Custom Events
`eo_impression`	Impressions
`eo_install`	Installs
`eo_open`	Opens
`eo_pageview`	Pageviews
`webhook2`	Postback Records
`eo_reinstall`	Reinstalls
`skadnetwork_invalid_messages`	SKAdNetwork Invalid Messages
`skadnetwork_valid_messages`	SKAdNetwork Valid Messages
`eo_sms_sent`	SMS Sent
`eo_user_lifecycle_event`	User Lifecycle Events
`eo_web_session_start`	Web Session Starts
`eo_san_touch`	Self-Attributing Network Touch

Available Fields

Fields	Type	Description
`app_id`	Long	App ID (capitalize ID in Liveview)
`app_name`	String	App Name
`attributed`	Boolean	Attributed
`content_items`	ArrayStruct	Content Items
`custom_data`	MapStringString	Custom Data
`customer_event_alias`	String	Customer Event Alias
`days_from_last_attributed_touch_to_event`	Integer	Days From Last Attributed Touch To Event
`deep_linked`	Boolean	Deep Linked
`di_match_click_token`	Long	DI Match Click Token
`event_data_ad_type`	enum { BANNER, INTERSTITIAL, REWARDED_VIDEO, NATIVE }	Ad Type
`event_data_affiliation`	String	Affiliation
`event_data_coupon`	String	Coupon
`event_data_currency`	String	Currency
`event_data_description`	String	Event Description
`event_data_exchange_rate`	Double	Exchange Rate
`event_data_revenue`	Double	Revenue
`event_data_revenue_in_usd`	Double	Revenue In USD
`event_data_search_query`	String	Search Query
`event_data_shipping`	Double	Shipping
`event_data_tax`	Double	Tax
`event_data_transaction_id`	String	Transaction ID
`event_data_local_currency`	String	Local Currency
`event_data_local_currency_exchange_rate`	String	Local Currency Exchange Rate
`event_data_revenue_in_local_currency`	String	Revenue in Local Currency
`event_data_custom_param_1`	String	Custom parameter for event
`event_data_custom_param_2`	String	Custom parameter for event
`event_data_custom_param_3`	String	Custom parameter for event
`event_timestamp`	Long	Event Timestamp
`existing_user`	Boolean	Existing User
`external_intent_uri`	String	External Intent URI
`first_event_for_user`	Boolean	First Event For User
`hash_version`	String	Hash Version
`hours_from_last_attributed_touch_to_event`	Integer	House From Last Attributed Touch To Event
`id`	String	ID
`install_activity_attributed`	Boolean	Install Attributed
`install_activity_data_has_clicked_ad`	Boolean	Install Has Clicked Ad
`install_activity_data_has_clicked_email`	Boolean	Install Has Clicked Email
`install_activity_timestamp`	Long	Install Timestamp
`install_activity_touch_data_additional_data_tilde_ad_id`	Long	Install Ad ID
`install_activity_touch_data_additional_data_tilde_ad_set_id`	Long	Install Ad Set ID
`install_activity_touch_data_additional_data_tilde_campaign_id`	Long	Install Campaign ID
`install_activity_touch_data_additional_data_tilde_creative_id`	Long	Install Creative ID
`install_activity_touch_data_dollar_3p`	String	Install Partner 3p Value
`install_activity_touch_data_plus_via_features`	String	Install Features
`install_activity_touch_data_plus_web_format`	String	Install Web Format
`install_activity_touch_data_tilde_ad_name`	String	Install Ad Name
`install_activity_touch_data_tilde_ad_set_name`	String	Install Ad Set Name
`install_activity_touch_data_tilde_advertising_partner_id`	Long	Install Ad Partner ID
`install_activity_touch_data_tilde_advertising_partner_name`	String	Install Ad Partner
`install_activity_touch_data_tilde_agency`	String	Install Agency
`install_activity_touch_data_tilde_agency_id`	Long	Install Agency ID
`install_activity_touch_data_tilde_campaign`	String	Install Campaign
`install_activity_touch_data_tilde_channel`	String	Install Channel
`install_activity_touch_data_tilde_creative_name`	String	Install Creative Name
`install_activity_touch_data_tilde_customer_ad_name`	String	Install Customer Ad Name
`install_activity_touch_data_tilde_customer_ad_set_name`	String	Install Customer Ad Set Name
`install_activity_touch_data_tilde_customer_campaign`	String	Install Customer Campaign
`install_activity_touch_data_tilde_customer_keyword`	String	Install Customer Keyword
`install_activity_touch_data_tilde_customer_placement`	String	Install Customer Placement
`install_activity_touch_data_tilde_customer_secondary_publisher`	String	Install Customer Secondary Publisher
`install_activity_touch_data_tilde_customer_sub_site_name`	String	Install Customer Sub Site Name
`install_activity_touch_data_tilde_feature`	String	Install Feature
`install_activity_touch_data_tilde_journey_name`	String	Install Journey Name
`install_activity_touch_data_tilde_keyword`	String	Install Keyword
`install_activity_touch_data_tilde_placement`	String	Install Placement
`install_activity_touch_data_tilde_secondary_publisher`	String	Install Secondary Publisher
`install_activity_touch_data_tilde_stage`	String	Install Stage
`install_activity_touch_data_tilde_tags`	String	Install Tags
`install_activity_touch_data_tilde_view_name`	String	Install View Name`
`install_activity_touch_type`	String	Install Touch Type
`last_attributed_touch_data_custom_fields`	String	Last Attributed Touch Custom Fields
`last_attributed_touch_data_dollar_3p`	String	Ad Partner (3p)
`last_attributed_touch_data_dollar_marketing_title`	String	Marketing Title
`last_attributed_touch_data_plus_current_feature`	String	Current Feature
`last_attributed_touch_data_tilde_id`	Long	Last Attributed Touch ID
`last_attributed_touch_data_plus_touch_id`	String	Last Attributed Touch Touch ID
`last_cta_view_data_plus_touch_id`	String	Last CTA View Touch ID
`last_attributed_touch_data_plus_via_features`	ArrayString	Via Features
`last_attributed_touch_data_plus_web_format`	String	Web Format
`last_attributed_touch_data_tilde_ad_id`	String	Ad ID
`last_attributed_touch_data_tilde_ad_name`	String	Ad Name
`last_attributed_touch_data_tilde_ad_set_id`	String	Ad Set ID
`last_attributed_touch_data_tilde_ad_set_name`	String	Ad Set Name
`last_attributed_touch_data_tilde_advertising_account_name`	String	Advertising Account Name
`last_attributed_touch_data_tilde_advertising_account_id`	String	Advertising Account ID
`last_attributed_touch_data_tilde_advertising_partner_id`	String	Ad Partner ID
`last_attributed_touch_data_tilde_advertising_partner_name`	String	Ad Partner
`last_attributed_touch_data_tilde_agency`	String	Agency
`last_attributed_touch_data_tilde_agency_id`	String	Agency ID
`last_attributed_touch_data_tilde_banner_dimensions`	String	Banner Dimensions
`last_attributed_touch_data_tilde_branch_ad_format`	String	Branch Ad Format
`last_attributed_touch_data_tilde_campaign`	String	Campaign
`last_attributed_touch_data_tilde_campaign_id`	String	Campaign ID
`last_attributed_touch_data_tilde_campaign_type`	String	Campaign Type
`last_attributed_touch_data_tilde_channel`	String	Channel
`last_attributed_touch_data_tilde_creative_name`	String	Creative Name
`last_attributed_touch_data_tilde_creative_id`	String	Creative ID
`last_attributed_touch_data_tilde_customer_ad_name`	String	Customer Ad Name
`last_attributed_touch_data_tilde_customer_ad_set_name`	String	Customer Ad Set Name
`last_attributed_touch_data_tilde_customer_campaign`	String	Customer Campaign
`last_attributed_touch_data_tilde_customer_keyword`	String	Customer Keyword
`last_attributed_touch_data_tilde_customer_placement`	String	Customer Placement
`last_attributed_touch_data_tilde_customer_secondary_publisher`	String	Customer Secondary Publisher
`last_attributed_touch_data_tilde_customer_sub_site_name`	String	Customer Sub Site Name
`last_attributed_touch_data_tilde_external_touch_id`	String	External Touch ID
`last_attributed_touch_data_tilde_feature`	String	Feature
`last_attributed_touch_data_tilde_journey_id`	String	Journey ID
`last_attributed_touch_data_tilde_journey_name`	String	Journey Name
`last_attributed_touch_data_tilde_keyword`	String	Keyword
`last_attributed_touch_data_tilde_keyword_id`	String	Keyword ID
`last_attributed_touch_data_tilde_optimization_model`	String	Optimization Model
`last_attributed_touch_data_tilde_placement`	String	Placement
`last_attributed_touch_data_tilde_placement_id`	String	Placement ID
`last_attributed_touch_data_tilde_secondary_ad_format`	String	Secondary Ad Format
`last_attributed_touch_data_tilde_secondary_publisher`	String	Secondary Publisher
`last_attributed_touch_data_tilde_secondary_publisher_id`	String	Secondary Publisher ID
`last_attributed_touch_data_tilde_stage`	String	Stage
`last_attributed_touch_data_tilde_sub_site_name`	String	Sub Site Name
`last_attributed_touch_data_tilde_tags`	ArrayString	Tags
`last_attributed_touch_data_tilde_technology_partner`	String	Technology Partner
`last_attributed_touch_data_tilde_touch_subtype`	String	Google Video Ads "Engaged View"
`last_attributed_touch_data_tilde_view_id`	String	View ID
`last_attributed_touch_data_tilde_view_name`	String	View Name
`last_attributed_touch_timestamp`	Long	Last Attributed Touch Timestamp
`last_attributed_touch_timestamp_iso`	String	Last Attributed Touch Timestamp (ISO)
`last_attributed_touch_type`	String	Last Attributed Touch Type
`last_cta_view_data_custom_fields`	String	Last CTA View Custom Fields
`last_cta_view_data_dollar_3p`	String	Last CTA View Ad Partner (3p)
`last_attributed_touch_data_plus_referring_domain`	String	Referring Domain
`last_cta_view_data_plus_via_features`	ArrayString	Last CTA View Via Features
`last_cta_view_data_plus_web_format`	String	Last CTA View Web Format
`last_cta_view_data_tilde_ad_id`	String	Last CTA View Ad ID
`last_cta_view_data_tilde_ad_name`	String	Last CTA View Ad Name
`last_cta_view_data_tilde_ad_set_id`	String	Last CTA View Ad Set ID
`last_cta_view_data_tilde_ad_set_name`	String	Last CTA View Ad Set Name
`last_cta_view_data_tilde_advertising_partner_name`	String	Last CTA View Ad Partner
`last_cta_view_data_tilde_agency`	String	Last CTA View Agency
`last_cta_view_data_tilde_banner_dimensions`	String	Last CTA View Banner Dimensions
`last_cta_view_data_tilde_branch_ad_format`	String	Last CTA View Branch Ad Format
`last_cta_view_data_tilde_campaign`	String	Last CTA View Campaign
`last_cta_view_data_tilde_campaign_id`	String	Last CTA View Campaign ID
`last_cta_view_data_tilde_campaign_type`	String	Last CTA View Campaign Type
`last_cta_view_data_tilde_channel`	String	Last CTA View Channel
`last_cta_view_data_tilde_creative_id`	String	Last CTA View Creative ID
`last_cta_view_data_tilde_creative_name`	String	Last CTA View Creative Name
`last_cta_view_data_tilde_external_touch_id`	Long	Last CTA View External Touch ID
`last_cta_view_data_tilde_feature`	String	Last CTA View Feature
`last_cta_view_data_tilde_id`	Long	Last CTA View ID
`last_cta_view_data_tilde_keyword_id`	String	Last CTA View Keyword ID
`last_cta_view_data_tilde_optimization_model`	String	Last CTA View Optimization Model
`last_cta_view_data_tilde_placement`	String	Last CTA View Placement
`last_cta_view_data_tilde_secondary_ad_format`	String	Last CTA View Secondary Ad Format
`last_cta_view_data_tilde_secondary_publisher`	String	Last CTA View Secondary Publisher<
`last_cta_view_data_tilde_stage`	String	Last CTA View Stage
`last_cta_view_data_tilde_tags`	ArrayString	Last CTA View Tags
`last_cta_view_data_tilde_technology_partner`	String	Last CTA View Technology Partner
`last_cta_view_timestamp`	Long	Last CTA View Timestamp
`last_cta_view_timestamp_iso`	String	Last CTA View Timestamp (ISO)
`\+match_guaranteed`	boolean	Flag that determines if the app session was made with 100% accuracy. Only available in Custom Exports API
`minutes_from_last_attributed_touch_to_event`	Integer	Minutes From Last Attributed Touch To Event
`name`	String	Name of event based on selected topic
`organization_id`	Long	Organization ID
`organization_name`	String	Organization Name
`origin`	String	Origin
`reengagement_activity_attributed`	Boolean	Reengagement Activity Attribute
`reengagement_activity_data_has_clicked_ad`	Boolean	Reengagement Has Clicked Ad
`reengagement_activity_data_has_clicked_email`	Boolean	Reengagement Has Clicked Email
`reengagement_activity_timestamp`	String	Reengagement Timestamp
`reengagement_activity_touch_data_additional_data_tilde_ad_id`	Long	Reengagement Ad ID
`reengagement_activity_touch_data_additional_data_tilde_ad_set_id`	Long	Reengagement Ad Set ID
`reengagement_activity_touch_data_additional_data_tilde_campaign_id`	Long	Reengagement Campaign ID
`reengagement_activity_touch_data_additional_data_tilde_creative_id`	Long	Reengagement Creative ID
`reengagement_activity_touch_data_dollar_3p`	String	Reengagement Partner 3p Value
`reengagement_activity_touch_data_plus_via_features`	String	Reengagement Features
`reengagement_activity_touch_data_plus_web_format`	String	Reengagement Web Format
`reengagement_activity_touch_data_tilde_ad_name`	String	Reengagement Ad Name
`reengagement_activity_touch_data_tilde_ad_set_name`	String	Reengagement Ad Set Name
`reengagement_activity_touch_data_tilde_advertising_partner_id`	Long	Reengagement Advertising Partner ID
`reengagement_activity_touch_data_tilde_advertising_partner_name`	String	Reengagement Advertising Partner Name
`reengagement_activity_touch_data_tilde_agency`	String	Reengagement Agency
`reengagement_activity_touch_data_tilde_agency_id`	Long	Reengagement Agency ID
`reengagement_activity_touch_data_tilde_campaign`	String	Reengagement Campaign
`reengagement_activity_touch_data_tilde_channel`	String	Reengagement Channel
`reengagement_activity_touch_data_tilde_creative_name`	String	Reengagement Creative Name
`reengagement_activity_touch_data_tilde_customer_ad_name`	String	Reengagement Customer Ad Name
`reengagement_activity_touch_data_tilde_customer_ad_set_name`	String	Reengagement Customer Ad Set Name
`reengagement_activity_touch_data_tilde_customer_campaign`	String	Reengagement Customer Campaign
`reengagement_activity_touch_data_tilde_customer_keyword`	String	Reengagement Customer Keyword
`reengagement_activity_touch_data_tilde_customer_placement`	String	Reengagement Customer Placement
`reengagement_activity_touch_data_tilde_customer_secondary_publisher`	String	Reengagement Customer Secondary Publisher
`reengagement_activity_touch_data_tilde_customer_sub_site_name`	String	Reengagement Customer Sub Site
`reengagement_activity_touch_data_tilde_feature`	String	Reengagement Feature
`reengagement_activity_touch_data_tilde_journey_name`	String	Reengagement Journey Name
`reengagement_activity_touch_data_tilde_keyword`	String	Reengagement Keyword
`reengagement_activity_touch_data_tilde_placement`	String	Reengagement Placement
`reengagement_activity_touch_data_tilde_secondary_publisher`	String	Reengagement Secondary Publisher
`reengagement_activity_touch_data_tilde_stage`	String	Reengagement Stage
`reengagement_activity_touch_data_tilde_tags`	String	Reengagement Tags
`reengagement_activity_touch_data_tilde_view_name`	String	Reengagement View Name
`reengagement_activity_touch_type`	String	Reengagement Touch Type
`referrer_click_timestamp`	Long	Referrer Click Timestamp
`seconds_from_install_to_event`	Integer	Seconds From Install To Event
`seconds_from_last_attributed_touch_to_event`	Integer	Seconds From Last Attributed Touch To Event
`seconds_from_last_attributed_touch_to_store_install_begin`	Integer	Seconds From Touch To Store Install Begin
`site_event_items_count`	Integer	Content Items Count
`store_install_begin_timestamp`	Long	Store Install Begin Timestamp
`timestamp`	Long	Timestamp
`timestamp_iso`	String	Timestamp (ISO)
`user_data_aaid`	String	AAID
`user_data_android_id`	String	Android ID
`user_data_app_version`	String	App Version
`user_data_brand`	String	Brand
`user_data_browser`	String	Browser
`user_data_build`	String	Build
`user_data_cpu_type`	String	CPU Type
`user_data_cross_platform_id`	String	Cross Platform ID
`user_data_developer_identity`	String	Developer Identity
`user_data_device_type`	String	Device Type
`user_data_environment`	String	Environment
`user_data_geo_city_code`	Integer	City Code
`user_data_geo_city_en`	String	City
`user_data_geo_country_code`	String	Country Code
`user_data_geo_country_en`	String	Country
`user_data_geo_dma_code`	Integer	DMA Code
`user_data_geo_lat`	Float	Latitude
`user_data_geo_lon`	Float	Longitude
`user_data_geo_postal_code`	String	Postal Code
`user_data_geo_region_en`	String	Region
`user_data_geo_region_code`	String	Region Code
`user_data_http_referrer`	String	HTTP Referrer
`user_data_idfa`	String	IDFA
`user_data_idfv`	String	IDFV
`user_data_internet_connection_type`	String	Internet Connection Type
`user_data_ip`	String	IP Address
`user_data_is_jailbroken`	Boolean	IIs Jailbroken
`user_data_kindle_id`	String	Kindle ID
`user_data_language`	String	Language
`user_data_limit_ad_tracking`	Boolean	Limit Ad Tracking
`user_data_model`	String	Model
`user_data_oaid`	String	Huawei OAID
`user_data_os`	String	OS
`user_data_os_version`	String	OS Version
`user_data_os_version_android`	String	OS Version (Android)
`user_data_past_cross_platform_ids`	ArrayString	Past Cross Platforms IDs
`user_data_platform`	ArrayString	Platform
`user_data_prob_cross_platform_ids`	ArrayStruct	Probabilistic Cross Platform IDs
`user_data_roku_rida`	String	Roku Device ID
`user_data_screen_height`	Integer	Screen Height
`user_data_screen_width`	Integer	Screen Width
`user_data_sdk_version`	String	SDK Version
`user_data_user_agent`	String	User Agent
`user_data_windows_aid`	String	Windows AID
`user_data_device_locale`	String	Device Locale
`user_data_carrier_name`	String	Carrier Name
`user_data_opted_in_status`	String	Whether user opted in to ATT or not
`user_data_app_store`	String	The app store the user downloaded from

Cthulhu Filter Specification

Cthulhu is a prefix notation syntax written in JSON for specifying filters on records (usually column-based records).

Purpose
Easily parses into an abstract syntax tree.

Glossary
any - any valid json basic value (number, string)
... - previous item in a list can repeat as many times as necessary

Name	Spec	Example	SQL Equivalent
eq	["eq",<> <>	["eq","x", 1]	x= 1
gt	["gt",<> <>	["gt","x", 1]	x> 1
gte	["gte",<> <>	["gte","x", 1]	x >= 1
lt	["lt",<> <>	["lt","x", 1]	x< 1
lte	["lte",<> <>	["lte","x", 1]	x <= 1
like	["like",<> <>	["like", "x", ". *foobar"]	x LIKE "% foobar"
between	["between",<> <> <>	["between", "x",1, 2]	x BETWEEN 1 AND 2x >= 1 AND x <= 2
In	["in", ,="">,="">	["in","x", 1,2, 3]	x IN (1,2,3)
and	["and", , ...]	["and",["gt","x", 1],["lt","x", 2]]	x> 1 AND x < 2
or	["or", , ...]	["or",["eq","x", 1],["eq", "x", 2]]	x = 1 OR x= 2
not	["not",]	["not",["eq","x", 1]]	x != 1
array_contains	["array_contains", , ]	["array_contains","last_attributed_touch_data_tilde_tags","Share"]	array_contains(array(1, 2, 3), 2)

Additional Examples

Filter	Meaning
`["eq","last_attributed_touch_data_dollar_3p","a_tiktok_ads"]`	Where `last_attributed_touch_data_dollar_3p` equals `a_tiktok_ads`.
`["eq","name","PURCHASE"]`	Where `name` equals `PURCHASE`.
`["or",["eq","name","store_page"],["eq","name","store_category_page"],["eq","name","dynamic_home_page"]]`	Where `name` equals `store_page`, `store_category_pay`, or `dynamic_home_page`.
`["and",["eq","last_attributed_touch_data_dollar_3p","a_google_adwords"],["not",["eq","last_attributed_touch_data_tilde_external_touch_id",""]]]`	Where `last_attributed_touch_data_dollar_3p` equals `a_google_adwords`, and `last_attributed_touch_data_tilde_external_touch_id` is not empty.

Scheduled Log Exports API Overview

Overview

Packaging

Benefits

Use Cases

Limits

Getting Started

Prerequisites

Cloud Storage

Access

General Access

Agency Access

Authentication

Usage

Get External ID

Request Info

Response Info

Example Request & Response

Create New Subscription

Request Info

Response Info

Examples

Deactivate Subscription

Request Info

Response Info

Example Request & Response

Get Details on Single Subscription

Request Info

Response Info

Example Request & Response

Get Details on All Subscriptions

Request Info

Response Info

Example Request & Response

Get Details on Single Export Job

Request Info

Response Info

Example Request & Response

Get Details on Many Export Jobs

Request Info

Request Query Parameters

Response Body Parameters

Example Request & Response

Appendix

Testing and Best Practices

Test Export and Cadence

Subscription Status Pending

Querying Exported Data

Available Topics

Available Fields

Cthulhu Filter Specification

Shortcuts

Company

Resources