---
title: "Bloomberg Data License Plus"
slug: "bloomberg-data-license-plus"
updated: 2025-12-18T16:33:52Z
published: 2025-12-18T16:33:52Z
canonical: "support.lusid.com/bloomberg-data-license-plus"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bloomberg Data License Plus

FINBOURNE’s Bloomberg Data License Plus (BBG DL+) integration allows you to enrich your LUSID instruments with comprehensive Bloomberg data across all instrument types. The integration maps this data to appropriate LUSID property types for immediate use in valuations and analytics.

BBG DL+ is one of Bloomberg’s enterprise Data License products. The commercial model optimises between Data License Bulk subscriptions and the pay-per-use model of [Data License Per Security](/v1/docs/bloomberg-data-license-per-security), grouping the most widely-used fields across the following datasets:

- Core entity
- Instrument
- Market
- Price
- ESG

[More information on Bloomberg Data License.](https://www.bloomberg.com/professional/products/data/data-management/data-license/#overview)

> [!WARNING]
> Prerequisites
> 
> Before getting started, ensure you have:
> 
> - [x] An active DL+ contract with Bloomberg
> - [x] Contacted your FINBOURNE representative to: - Complete a Third Party Processing and Hosting Agreement (TPPHA) with Bloomberg and FINBOURNE - Enable the integration in your LUSID domain - Provide you with the IP addresses you’ll need to whitelist for the application in Bloomberg

## Supported data types

### Instrument types

LUSID supports all instrument types for instrument enrichment.

### Fields

If one of your required fields isn’t currently available, [contact your FINBOURNE representative](https://www.finbourne.com/contact).

## Setting up the integration

### Step 1: Obtain Bloomberg DL+ credentials

1. Contact your Bloomberg account representative to set up API access for your DL+ subscription.
2. Obtain and securely store your **DL+ Key** and **DL+ Issuer** - you’ll need to provide these in LUSID.
3. Add the **Allowed IPs** provided by your FINBOURNE representative.

### Step 2: Create an integration instance

An integration instance is a configuration that defines which Bloomberg data fields to import.

1. Sign in to the LUSID web app.
2. Navigate to **Integrations > Dashboard**.
3. Select **Create instance** and choose **Bloomberg Data License Plus**. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-5M0WI0QP.png)
4. Specify the following **Integration details**:
  - **Name**: A friendly name for this integration instance
  - **Description**: A detailed description
  - **Edit imported properties > Add properties**: Select which Bloomberg data fields to import

> [!NOTE]
> Note
> 
> You can select the **View imported fields** button to inspect how LUSID maps your Bloomberg data.

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-N3Z8LG6A.png)
5. Specify the following **Integration settings**:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-17RVLNK4.png)
  - **DL+ Credentials - Key** and **Issuer**: Your DL+ credentials from [step 1](/v1/docs/bloomberg-data-license-plus#step-1-obtain-bloomberg-dl-credentials)
  - **Download Drive File Path**: Optional; a path starting with `LUSID-Horizon` to download data import troubleshooting files in
6. Choose whether to **Enable integration** on creation, then click **Save**. Note the **Instance ID**, which you’ll need for certain [run methods](/v1/docs/bloomberg-data-license-plus#running-the-integration).

### Step 3: Select the instruments to import data for

LUSID selects instruments to import Bloomberg data for using the `Instrument/LUSIDConfig-Bloomberg-DLPlus/RefreshReferenceData` property.

1. Ensure your instruments have at least one of the following [identifiers](/v1/docs/understanding-instrument-identifiers):
  - `BloombergUniqueId` (recommended for best results; this identifier ensures the result is unambiguous)
  - `Figi`
  - `Sedol`
  - `Isin`
2. [Follow these steps](/v1/docs/how-do-i-add-a-property-to-an-entity#using-the-lusid-web-app) to add the instrument property with scope `LUSIDConfig-Bloomberg-DLPlus` and code `RefreshReferenceData` to your instruments. Set the property value to **True** on the instruments you want to include in the integration runs. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-FNJN9M2G.png)

## Running the integration

You can run the integration manually using the **Integrations** dashboard, an API call, or via a Luminesce query. [See how to run an integration instance.](/v1/docs/setting-up-an-integration#running-an-integration)

## Monitoring and troubleshooting integration runs

[See how to monitor integrations and troubleshoot general issues.](/v1/docs/setting-up-an-integration#viewing-and-troubleshooting-all-runs)

LUSID adds Bloomberg data to instruments as properties in the `LUSID-Bloomberg-DLPlus` scope.

### Data handling and field mapping

Bloomberg provides data in various formats. The integration converts Bloomberg field types into [LUSID data types](/v1/docs/what-is-a-data-type) to ensure the data works seamlessly in your LUSID operations.

#### Field mapping

| Bloomberg field type | LUSID data type | Notes |
| --- | --- | --- |
| Boolean | `boolean` |  |
| Date | `date` |  |
| Integer | `number` |  |
| Real | `number` |  |
| Price | `number` |  |
| Character | `string` | Short text fields |
| Long character | `unindexedText` | Text fields up to ~500,000 characters; [read more](/v1/docs/storing-large-amounts-of-information-in-properties) |
| Bulk format | `unindexedText` | Large data sets |

#### Data quality handling

Bloomberg data doesn’t always conform to the expected field type. If a field contains:

- A value of `N/A`, `U/A`, or an empty string, LUSID treats this as a deletion of any previous value.
- A value that LUSID cannot convert to the expected data type, for example a whitespace string instead of numeric data, LUSID logs these values as `AttributeFailed` in the **Run details**.

You can review the [run logs](/v1/docs/setting-up-an-integration#viewing-and-troubleshooting-all-runs) for each integration instance to identify data quality issues.

---

### Troubleshooting

#### Error: `Connection timed out`

If you experience this error, check the IP addresses provided by FINBOURNE have been whitelisted in your BBG DL+ account.

#### Error: `Authentication failed`

If you experience this error:

- [x] Check your **DL+ Key** and **Issuer** credentials are correct in your integration instance configuration
- [x] Contact your Bloomberg account representative to ensure your API access is configured correctly

#### No Bloomberg data imported for instruments

Check the following:

- [x] Your connection and authentication to Bloomberg is working (see troubleshooting above)
- [x] Instruments have the `Instrument/default/BloombergUniqueId` identifier
- [x] Instruments have the `Instrument/LUSIDConfig-Bloomberg-DLPlus/RefreshReferenceData` property, with the value set to `True`
- [x] The integration instance is [configured to import the relevant fields](/v1/docs/bloomberg-data-license-plus#step-2-create-an-integration-instance)