Main Content


Create Bloomberg Hypermedia field list for data requests

Since R2023b



[fieldListID,response] = createFieldList(c,userCatalog,payload) creates a Bloomberg® Hypermedia field list for data requests, where c is the Bloomberg Hypermedia connection object, userCatalog is your catalog ID from Bloomberg, and payload is a structure that defines the field list.


collapse all

Create a field list for the data fields you would like to request.

Create a Bloomberg Hypermedia connection object by using the API key provided by Bloomberg.

credentialsString = '{"client_id":"89beaeab724bbdf5e186b733c58af2","client_secret":"77050429aee81eb31793fb10fa4301c54911db545de8b2990252ffe2b56b11","name":"BloombergHAIDevelopment","scopes":["eap","beapData","reportingapi"],"expiration_date":1699198358934,"created_date":1651764758934}'
c = bloombergHypermedia(credentialsString)
c = 
  bloombergHypermedia with properties:

      TimeOut: 200.00

Specify your catalog ID and create the payload structure that holds the essential query information required by the Bloomberg Hypermedia data server.

userCatalog = "123";
payload.type = "DataFieldList";
payload.identifier = "fieldList" + bloombergHypermedia.generateResourcePostfix;;
payload.title = "Test Data Field List";
payload.description = "Test data field list";
payload.contains{1}.id = "";
payload.contains{2}.id = "";
payload.contains{3}.id = "";

Use the createFieldList function to create the field list.

[fieldListID,response] = createFieldList(c,userCatalog,payload)
fieldListID = 
response = 
       ResponseMessage with properties:
         StatusLine: 'HTTP/1.1 201 CREATED'
         StatusCode: Created
            Header: [1×14]
              Body: [1×1]
         Completed: 1

After creating the field list, you can use this output to create a data request by using the createRequest function.

Input Arguments

collapse all

Bloomberg Hypermedia connection, specified as a Bloomberg Hypermedia object.

User catalog identifier, specified as a character vector or string scalar.

Field list information, specified as a structure array.

Output Arguments

collapse all

Field list identifier, returned as a string scalar.

HTTP request response, returned as a ResponseMessage object. For details, see

Version History

Introduced in R2023b