Using The RelativePath And Query Options With Web.Contents() In Power Query And Power BI M Code

The Web.Contents() function in M is the key to getting data from web pages and web services, and has a number of useful – but badly documented – options that make it easier to construct urls for your web service calls.

Consider the following url:

It is a call to the metadata api (documentation here) for, the UK government’s open data portal, and returns a JSON document listing all the datasets found for a search on the keyword “cows”. You can make this call using Web.Contents() quite easily like so:


However, instead of having one long string for your url (which will probably need to be constructed in a separate step) you can use the RelativePath and Query options with Web.Contents(). They are given in the second parameter of the function and passed through as fields in a record. RelativePath adds some extra text to the base url given in the first parameter for the function, while Query allows you to add query parameters to the url, and is itself a record.

So, taking the example above, if the base url for the api is we can use these options like so:


RelativePath is just the string “3/action/package_search” and is added to the base url. There is just one query parameter “q”, the search query, and the search term is “cows”, so Query takes a record with one field: [q=”cows”]. If you want to specify multiple query parameters you just need to add more fields to the Query record; for example:


Generates a call that returns 20 results, rather than the default 10:

Obviously these options make it easier to construct urls and the code is much clearer, but there are also other benefits to using these options which I’ll cover in another blog post soon.

Note: at the time of writing there is a bug that causes the value given in RelativePath to be appended twice when the Web.Page() function is also used. Hopefully this will be fixed soon.

UPDATE January 2021: This blog post has more details on using the Query option:

85 responses

  1. Pingback: Dew Drop - August 16, 2016 (#2310) - Morning Dew

  2. Pingback: daily 08/16/2016 | Cshonea's Blog

  3. Pingback: Web.Contents(), M Functions And Dataset Refresh Errors In Power BI – Chris Webb's BI Blog

  4. Pingback: Dynamic Web.Contents() and Power BI Refresh Errors – Data Inspirations

  5. Pingback: Implementing Basic Query Folding On A Web Service In Power Query/M And Power BI « Chris Webb's BI Blog

  6. Pingback: Credentials, Data Privacy Settings And Data Sources In Power Query/Power BI « Chris Webb's BI Blog

  7. Hi Chris, quick question which keeps puzzling us. After finding this brilliant solution of yours we proceeded but ran into a new problem. The API we are calling uses the same query option 4 times.

    The URL would be something along the lines of:


    In your example this would lead to:
    Query =
    properties = “value1”,
    properties = “value2”,
    properties = “value3”,
    properties = “value4”,
    hapikey = “xxxxxxxxxxxxxxxxxxxxxx”,

    I feared this would pose a problem, knowing how standard arrays work, the last value assigned to properties would over write all previous ones. And indeed Power BI M actually warns for this problem.

    Any idea how to circumvent this?

    sincerely, Wouter

  8. Thank you very much for your reply. Unfortunately power bi encodes all data between “”, and although it skips the quotes, the ampersand and the equal sign all get encoded rendering the string unusable. I even installed Netmon to observe this from happening. (thankfully the api was reachable using http instead of https) I – again – am at a loss. Any new ideas?

  9. Hi Chris,

    Thanks for this article.

    I encounter an issue where the data from the website does not return correctly it seems if I use multiple query string.

    For example,

    this works fine – the data returns correctly (not using Query option)
    Source = Json.Document(Web.Contents(“”&userAgent_URLEncoded&”&getJSON=all”)),

    but this will cause failure in Scheduled Data Refresh in Power BI, so I have to use the Query option, like below.

    Source = Json.Document(Web.Contents(“”,[Query=[uas=userAgent_URLEncoded,getJSON=”all”]])),

    However, it seems that the data is not parsed in correctly, and I’ve got unknown values for most of the records.

    Try using
    userAgent_URLEncoded = Mozilla%2F5.0%20%28Windows%20NT%2010.0%3B%20Win64%3B%20×64%29%20AppleWebKit%2F537.36%20%28KHTML%20%20like%20Gecko%29%20Chrome%2F69.0.3497.100%20Safari%2F537.36

    Do you know why?


  10. We have tried using your method, and it works for PBIX and updates in the workbool, but when we upload to PBIS, and try to run the refresh there, the only APIs that will connect are those that do not use your method of breaking the relative path out from the main URL string. All of our data sources (APIs) that are called with the relative path in the main URL string work, and those where we use your method to break them out into their own relative path are unable to connect to the API for data refresh via PBIS. The same queries that work on the desktop do not connect or work in PBIS.

    • Hmm, that suggests something else is going on here. Have you turned off data privacy checks in Power BI Desktop? If so, does refresh fail when you turn on the data privacy checks?

  11. What about if the query parameter name contains a pipe?

    Like this – query_start_date|lt

    (not me, but the API i am trying to hit) – is there any way to wrap it so PowerBI accepts it? currently throws an Invalid Identifier error

  12. This worked perfectly for me but then I found that it requires a gateway. I’m doing straight web calls, any idea how to skip the gateway?

  13. I can’t make it work for any way in order to schedule refresh data. I have even check 404 errors. In Power Bi desktop works perfectly. It is azure devops api.

    I’m getting: “We reached the end of the buffer.. The exception was raised by the IDataReader interface. Table: Query1”


    Capacity = (ProjectSK as text, IterationSK as text, AssignedToUserSK as text) =>

    Url = Web.Contents(“”, [RelativePath=”/[Companyname]/” & ProjectSK & “/” & “_apis/work/teamsettings/iterations/” & IterationSK & “/capacities/” & AssignedToUserSK , ManualStatusHandling={404}, Query=[#”api-version”=”5.0″]] ),
    Origen = Table.FromColumns({Lines.FromBinary(Url, null, null, 65001)}),
    #”JSON analizado” = Table.TransformColumns(Origen,{},Json.Document),
    #”Se expandió Column1″ = Table.ExpandRecordColumn(#”JSON analizado”, “Column1”, {“teamMember”, “activities”, “daysOff”, “url”, “_links”}, {“Column1.teamMember”, “Column1.activities”, “Column1.daysOff”, “Column1.url”, “Column1._links”}),
    #”Se expandió Column1.activities” = Table.ExpandListColumn(#”Se expandió Column1″, “Column1.activities”),
    #”Se expandió Column1.activities1″ = Table.ExpandRecordColumn(#”Se expandió Column1.activities”, “Column1.activities”, {“capacityPerDay”, “name”}, {“Column1.activities.capacityPerDay”, “”}),
    #”Columnas quitadas” = Table.RemoveColumns(#”Se expandió Column1.activities1″,{“Column1.teamMember”, “”, “Column1.daysOff”, “Column1.url”, “Column1._links”}),
    #”Columnas con nombre cambiado” = Table.RenameColumns(#”Columnas quitadas”,{{“Column1.activities.capacityPerDay”, “capacityPerDay”}}),
    GetMetadata = Value.Metadata(Url),
    GetResponseStatus = GetMetadata[Response.Status],
    Output = if GetResponseStatus=404 then Table.FromRecords({[capacityPerDay = 0]}) else #”Columnas con nombre cambiado”


      • It is curious how Power Bi Service is different to Desktop. I found my solution taking [CompanyName] out of relative path to join de URL parameter in Web.Content. It doesn’t have so much sense, but it is actually working.

  14. Since this albeit very useful post is written in 2016 it ends with “Note: at the time of writing there is a bug that causes the value given in RelativePath to be appended twice when the Web.Page() function is also used. Hopefully this will be fixed soon.”

    This bug seems to be ongoing still today.

    I can’t get my function to work with the Query parameter when I use Web.Page() around the Web.Contents(“url”, [Query=[term=value]])

    However it works when I use Web.Page(Web.Contents(“url/?term=value)) (No

    I really wanted to let my custom connection run through a gateway but stumbled upon the unsupported source error because of Web.Contents() function – hence me reading this post.

    Now I seem to have two problems instead of one. 😐

  15. I have a API URL which works like this :
    to get the data from JIRA , the param is RC-2345 in this rest is static , how can we create a similar funtion to pass the JIRAID as param , i tried the below sample function but it doesnt pass it correctly.

    = (JIRAID as text) =>
    let Source = Json.Document(Web.Contents(“”, [Query=[JIRAID]], [RelativePath=”worklog/”]))
    in Source

  16. Pingback: Historical Stock Price Function in Power Query - Power BI Tips and Tricks

  17. Have you ever seen an issue where it adds a “/” into the url?
    The API I’m trying to hit is something like this:
    RelativePath =”?metrics=metric1,metric2,metric3&project=”
    The problem is that it shoots out,metric2,metric3&project=ProjectName
    because it adds a “/” automatically before the relativepath.

  18. Pingback: Tips, Gateway, Embedding and Analysis Services – Roundup #57 – Power BI Videos

  19. Pingback: Power BI Auditing – Power BI Videos

  20. Hi Chris,
    I have been exploring using USERNAME() or USEPRINCIPALNAME() to dynamically assign the Paranmeter value in the Web.Contents query. The idea is to extract relevant data based on Power BI login user. Using RLS is possible however this alternative (if possible) will greatly reduce the number of records extracted for respective users.
    Do you think this is possible ?

  21. Chris, first of all, thanks for this incredibly helpful post! I’ve tried to follow what you have done and the code works fine in the desktop, but I’m still having problems with not being able to refresh the data when I have published to the powerbi service.

    I’m actually connecting to an ODATA service, and had to figure out how to use params with ‘$’ signs in the name, so the example below might be helpful to others doing the same thing.

    I did try and import the data using an ODATA data source, but was having problems, hence ended up going this route:

    BaseUri = “https://myurl/v1/”,
    QueryRecord =
    [ RelativePath=”tickets/”,
    token = “xxxxxxxxxx”,
    #”$select” = “id,type,origin,baseStatus,createdDate,slaSolutionDate,slaSolutionTime,resolvedIn,urgency,serviceFull,subject”,
    #”$filter” = “createdDate gt ” & FormattedDate & “-05:00 and baseStatus ne ‘Canceled'”,
    #”$top” = “1000”,
    #”$skip” = “1”
    Source = Json.Document(
    Web.Contents( BaseUri, QueryRecord )

    Anything obvious I am doing wrong?



    • I am also extremely interested in a solution for this problem. We are trying to use Microsoft Graph api “skiptoken” element which is preceded by a dollarsign too.

  22. Pingback: Chris Webb's BI Blog: Implementing Basic Query Folding On A Web Service In Power Query/M And Power BI Chris Webb's BI Blog

  23. Pingback: Chris Webb's BI Blog: Web.Contents(), M Functions And Dataset Refresh Errors In Power BI Chris Webb's BI Blog

  24. I have been facing this Issue for a week and tried various approaches to fix it with no positive results 🙁

    I have set a Parameter that provides the ability to make a Dynamic URL with the Following Code which would later be merged with a list-to-table Query:

    Document=(Numero as number)as table =>
    Source = Web.Contents(“”&Number.ToText(Numero)&”&mastertable=dbo.barriocolonia”,[RelativePath=”Numero”]),

    #”Extracted Table From Html” = Html.Table(Source, {{“Column1”, “TABLE[id=’form_grid_8′] > TR > :nth-child(1), TABLE[id=’form_grid_8′] > * > TR > :nth-child(1)”}, {“Column2”, “TABLE[id=’form_grid_8′] > TR > :nth-child(2), TABLE[id=’form_grid_8′] > * > TR > :nth-child(2)”}, {“Column3”, “TABLE[id=’form_grid_8′] > TR > :nth-child(3), TABLE[id=’form_grid_8′] > * > TR > :nth-child(3)”}, {“Column4”, “TABLE[id=’form_grid_8′] > TR > :nth-child(4), TABLE[id=’form_grid_8′] > * > TR > :nth-child(4)”}}, [RowSelector=”TABLE[id=’form_grid_8′] > TR, TABLE[id=’form_grid_8′] > * > TR”]),
    #”Promoted Headers” = Table.PromoteHeaders(#”Extracted Table From Html”, [PromoteAllScalars=true]),
    #”Changed Type” = Table.TransformColumnTypes(#”Promoted Headers”,{{“Id Colonia”, Int64.Type}, {“Barrio o Colonia”, type text}, {“Salida de Tanque”, type text}, {“Horario”, type text}})

    #”Changed Type”
    in Document

    Static example of one of the URLS would be :””

    How would the Relative Path and Query solution be applied in this context to solve the Refresh Solution in the PBI Service?

    • Just Fixed it with help of a friend, turns out it was simpler than I thought:

      Source = Web.Contents(“”,[Query=[masterkey1=Number.ToText(Numero),mastertable=”dbo.barriocolonia”]]),

  25. Pingback: Hente data fra API’er til Power BI | Gaute Holmin - Teknologi, livet og sånt...

  26. I got a similiar problem with the upload refresh and i am unable to implement a RelativePath. Either I have a too big dimension or my syntax is not correct. How would you do this? The line without the Relative Path is

    WebCall = Json.Document(Web.Contents(URL & “/webapp/api/v1/salesOrder/?pageSize=1000&sort=-id&page=”&Text.From([Page])&””, [Headers=[AuthenticationToken=”” & token & “”, #”Content-Type”=”application/json”, Accept=”application/json”]]))

    Best regards
    Raphael Schmidt

  27. Pingback: Power BI Incremental Refresh with Web API Data Source | Data and Analytics with Dustin Ryan

  28. Pingback: Como obter dados de APIs e atualizar automaticamente - Aprenda Power BI

  29. Pingback: Resources to learn Power Query – Ninmonkey

  30. Hi Chris,
    I am having a very similar issue with trying to connect to a SharePoint.Files() source.
    I need to be able to access a set of files that over time will move from a Development SharePoint folder to an Operations folder.
    My original plan was to connect to an excel file that would contain the url pathways (root, path, file), and then load my data using parameters against that excel file.
    It works a treat in desktop, but then I get the “Dynamic data source” error once published to a workspace.
    Is it possible to use a similar “relative path” solution using SharePoint.Files() as a source?

  31. Pingback: How to get and automatically refresh APIs data - Power BI Experience

  32. Hi Chris,
    Dynamic URL with Web.Contents and RelativePath worked well on Power BI Report Server (May 2020).
    But since we upgraded to Power BI Report Server (October 2020) the refresh failed with this beautiful message :
    [0] -1056505856: COM error: mscorlib, An item with the same key has already been added..
    [1] -1056505856: COM error: System.Core, Sequence contains no elements.
    [2] -1055784828: The database operation was cancelled because of an earlier failure.

    • We’re getting the same error an in our case, it looks like it’s being caused by a Table.Combine statement – it worked fine before the October release and now fails to refresh on PBI Server. Not sure if that’s your issue, but if so, just here to tell you that I’m not aware of a work-around….

  33. Pingback: Chris Webb's BI Blog: Handling Multiple URL Query Parameters With The Same Name Using Web.Contents In Power Query/Power BI Chris Webb's BI Blog

  34. Need help with power Query to schedule dynamic refresh of data and keep old data


    I need to keep the data for the past 24 hours that I refresh in power BI desctop (thats how I model my report and dataset)
    I have premium and pro account
    I have set RangeStart and RangeEnd parameters
    schedule data refresh and update the data in first point every 15 minutes in power BI workspace ( here I get that my data source is not supported for refresh error – ” This dataset includes a dynamic data source. “)
    I have read this blog post about “Faking Out” Web.Contents (, but I cannot seem to get it working.
    Below is my query, any help would be much appreciated:

    EntitiesPerPage = 500,
    Limit=”&limit=” & Text.From(EntitiesPerPage),
    Url = “https://*******.********.com/api/1/rest/public/runtime/dev_org2?org_wide=true&last_hours=24” & Limit,
    GetJson = (Url) =>
    RawData = Web.Contents(Url),
    Json = Json.Document(RawData)
    in Json,

    GetEntityCount = () =>
    let Url = Url & “&offset=0″,
    Json = GetJson(Url),
    Count = Json[#”response_map”],
    Count1 = Count[#”total”]

    GetPage = (Index) =>
    //(option A)offset equal to previous row count
    offset = “&offset=” & Text.From(Index * EntitiesPerPage),
    //(option B)offset equal to page numer
    //offset = “&offset=” & Text.From(Index),
    Url = Url & offset,
    Json = GetJson(Url),
    Value = Json[#”response_map”],
    Value1 = Value[#”entries”]

    EntityCount = GetEntityCount(),
    PageCount = Number.RoundUp(EntityCount / EntitiesPerPage),
    PageIndices = { 0 .. PageCount – 1 },
    Pages = List.Transform(PageIndices, each GetPage(_)),
    Entities = List.Union(Pages),
    Table = Table.FromList(Entities, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #”Expanded Column1″ = Table.ExpandRecordColumn(Table, “Column1”, {“documents”, “state_timestamp”, “error_documents”, “label”, “path_id”, “state”, “create_time”, “duration”, “cc_label”, “runtime_label”}, {“Column1.documents”, “Column1.state_timestamp”, “Column1.error_documents”, “Column1.label”, “Column1.path_id”, “Column1.state”, “Column1.create_time”, “Column1.duration”, “Column1.cc_label”, “Column1.runtime_label”}),
    #”Renamed Columns” = Table.RenameColumns(#”Expanded Column1″,{{“Column1.cc_label”, “cc_label”}, {“Column1.create_time”, “create_time”}, {“Column1.documents”, “documents”}, {“Column1.duration”, “duration”}, {“Column1.error_documents”, “error_documents”}, {“Column1.label”, “label”}, {“Column1.path_id”, “path_id”}, {“Column1.state”, “state”}, {“Column1.runtime_label”, “runtime_label”}, {“Column1.state_timestamp”, “state_timestamp”}}),
    #”Changed Type” = Table.TransformColumnTypes(#”Renamed Columns”,{{“state_timestamp”, type datetime}, {“create_time”, type datetime}}),
    #”Filtered Rows” = Table.SelectRows(#”Changed Type”, each [state_timestamp] >= RangeStart and [state_timestamp] < RangeEnd)
    #"Filtered Rows"



  35. Hi chris,

    Iam having the same data source refresh issue. I followed your blog but still finding issue.

    Could anyone help me in creating the relative path and query for the below code

    Source = Json.Document(Web.Contents(“”&Date.ToText(EndDate, “yyyy-MM-dd”)& “T23:00:00.000Z”&”&start=”&Date.ToText(StartDate, “yyyy-MM-dd”)& “T00:00:00.000Z”&””, [Headers=[Accept=”application/vnd.newvoicemedia.v3+json”, Authorization=”bearer “&GetAccessToken()]])),

    items = Source[items],
    #”Converted to Table” = Table.FromList(items, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #”Expanded Column1″ = Table.ExpandRecordColumn(#”Converted to Table”, “Column1”, {“agentId”, “start”, “status”, “duration”, “state”, “reason”, “interaction”, “channel”}, {“agentId”, “start”, “status”, “duration”, “state”, “reason”, “interaction”, “channel”}),
    #”Expanded interaction” = Table.ExpandRecordColumn(#”Expanded Column1″, “interaction”, {“guid”, “medium”, “mediumManager”, “direction”}, {“guid”, “medium”, “mediumManager”, “direction”}),
    #”Expanded channel” = Table.ExpandRecordColumn(#”Expanded interaction”, “channel”, {“guid”}, {“guid.1″}),
    #”Changed Type” = Table.TransformColumnTypes(#”Expanded channel”,{{“guid”, type text}})
    #”Changed Type”


  36. Hi Chris,

    I have a small dataset of about 6 workbooks that are stored across various places in a large SharePoint site.

    I can’t use a gateway and the Folder connector, because the file paths are too many characters, and I can’t move the files.

    Using the SharePoint.Files connector works, but the report takes between 1-2hrs to refresh about 1,000 rows of data, and often fails due to api/contextinfo error.

    Using SharePoint.Contents doesn’t help in this case, as the files are spread throughout too many different folder paths.

    This got me thinking about your Web.Contents RelativePath solution. I had read it, but never attempted to implement it.

    While I can build a Dynamic Data Source that refreshes the SharePoint files in Desktop in about 1 minute using the Web.Contents approach, I can’t seem to take advantage of the RelativePath option because I can’t authenticate into the subsite.

    my code:

    Desktop Solution works a charm:

    =Excel.Workbook(Web.Contents(Root&Path&File), null, true)

    Root, Path, File are obviously Parameters, and then I use a function to call the correct details.

    So, I attempted to modify this approach for the service:

    =Excel.Workbook(Web.Contents(“”, [RelativePath=Path&File]), null, true)

    In theory I thought this should work, because if i type “” into my browser, I can sign in and all is good.

    BUT, in Power Query, I have to add a suffix to the URL before I can successfully authenticate:


    This Suffix obviously messes with my ability to use RelativePath.

    Do you know why I can’t authenticate into “” by itself?

    Any ideas how I could overcome this?

  37. Pingback: Integrating Workspace ONE Intelligence reports with PowerBI – Arsen Bandurian: Technical Blog

  38. Pingback: Power Query - Dynamic Data Source and Web.Contents() - Hat Full of Data

  39. Pingback: powerquery - Unable to refresh dynamic data source in PowerBI service via using anonymous web API access? - androidarsenal

  40. Hi Chris,

    below is my code

    BaseURL = “”,
    Token = AccessToken,
    Options = [Headers=[Authorization=”Bearer ” & Token]],
    URL = BaseURL,
    //Define a function that would take step/page as parameter and return results
    Source = Json.Document(Web.Contents(URL, Options)),
    #”Converted to Table” = Table.FromList(Source, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #”Expanded Column1″ = Table.ExpandRecordColumn(#”Converted to Table”, “Column1”, {“transactionDate”, “customerId”, “shopId”, “posId”, “transactionReceiptId”, “updatedByClerkId”, “spend”, “balanceDifference”, “creditLimit”, “loyaltyPointsEarned”, “loyaltyPointsManuallyRewarded”, “loyaltyPointsSpent”, “type”, “currencyCode”}, {“transactionDate”, “customerId”, “shopId”, “posId”, “transactionReceiptId”, “updatedByClerkId”, “spend”, “balanceDifference”, “creditLimit”, “loyaltyPointsEarned”, “loyaltyPointsManuallyRewarded”, “loyaltyPointsSpent”, “type”, “currencyCode”}),
    #”Changed Type” = Table.TransformColumnTypes(#”Expanded Column1″,{{“transactionDate”, type datetime}, {“customerId”, Int64.Type}, {“shopId”, Int64.Type}, {“posId”, Int64.Type}, {“transactionReceiptId”, Int64.Type}, {“updatedByClerkId”, Int64.Type}, {“spend”, Int64.Type}, {“balanceDifference”, Int64.Type}, {“creditLimit”, Int64.Type}, {“loyaltyPointsEarned”, Int64.Type}, {“loyaltyPointsManuallyRewarded”, type logical}, {“loyaltyPointsSpent”, Int64.Type}, {“type”, Int64.Type}, {“currencyCode”, type text}}),
    #”Filtered Rows” = Table.SelectRows(#”Changed Type”, each ([transactionDate] #datetime(1, 1, 1, 0, 0, 0))),
    //Find the current date and time when this query runs
    CurrentDateTime = DateTimeZone.FixedUtcNow(),
    //Find yesterday’s date
    PreviousDay = Date.AddDays(DateTime.Date(CurrentDateTime),-1),
    //Put the current date and time in a new column in the table
    #”Added Custom” = Table.AddColumn(#”Filtered Rows”, “UTC Data Load Date”, each CurrentDateTime),
    #”Changed Type3″ = Table.TransformColumnTypes(#”Added Custom”,{{“UTC Data Load Date”, type datetimezone}}),
    //Add the filter required for incremental refresh
    //Only return rows in this table if:
    //a) The RangeStart parameter equals yesterday’s date, and
    //b) RangeEnd is not null (which should never be true)
    #”Filtered Rows (1)” = Table.SelectRows(#”Changed Type3″, each DateTime.Date(RangeStart)=PreviousDay and RangeEndnull)
    #”Filtered Rows (1)”

    This code is working fine in Power BI Desktop but
    I am getting below error while refreshing from Power BI service.

    This dataset includes a dynamic data source. Since dynamic data sources aren’t refreshed in the Power BI service, this dataset won’t be refreshed. Learn more:

    Please help to resolve the issue

      • The below code resolved my issue.

        Source = (ID as number) => let
        Source = Json.Document(Web.Contents(“xxxxxxxxxxxxxxxxx”,
        [RelativePath =”xxxxxxxxxxxxxxxxx?”,Query=[per_page=”500″,page=Number.ToText(ID)], Headers=[#”Authorization”=authkey]])),
        #”Converted to Table” = Table.FromList(Source, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
        #”Expanded Column1″ = Table.ExpandRecordColumn(#”Converted to Table”, “Column1”, {“enrollment_id”, “content_type”, “module_name”, “user”, “campaign_name”, “enrollment_date”, “start_date”, “completion_date”, “status”, “time_spent”, “policy_acknowledged”}, {“enrollment_id”, “content_type”, “module_name”, “user”, “campaign_name”, “enrollment_date”, “start_date”, “completion_date”, “status”, “time_spent”, “policy_acknowledged”}),
        #”Expanded user” = Table.ExpandRecordColumn(#”Expanded Column1″, “user”, {“id”, “first_name”, “last_name”, “email”}, {“id”, “first_name”, “last_name”, “email”})
        #”Expanded user”

  41. Hi, I too have followed the blog, but am facing the same issue as the others – the dynamic source can’t be refreshed. I wonder where I have gone wrong?

    Source = (Team_ID as text) => let
    Path = “”,
    Repath = “vfuk-digital/_apis/projects/digital/teams/”&Team_ID&”/members?”,
    Source = Json.Document(Web.Contents(Text.From(Path), [RelativePath=Repath, ManualStatusHandling={404}, Query=[#”api-version”=”6.0″]])),
    value = Source[value],
    #”Converted to Table” = Table.FromList(value, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #”Expanded Column2″ = Table.ExpandRecordColumn(#”Converted to Table”, “Column1”, {“identity”}, {“identity”}),
    #”Expanded identity” = Table.ExpandRecordColumn(#”Expanded Column2″, “identity”, {“displayName”, “id”, “uniqueName”}, {“displayName”, “id”, “uniqueName”}),
    #”Changed Type” = Table.TransformColumnTypes(#”Expanded identity”,{{“displayName”, type text}, {“id”, type text}, {“uniqueName”, type text}})
    #”Changed Type”

  42. Hi Mr. Chris, those were really helpful blogs that you have written, unfortunately for me the scenario is little different, we are fetching data from cloud service provider but we are getting 1000 records per request along with nextPaginated code, however i have managed to write for each loop and able to get data, but sadly after all the hard work I am getting below error, hoping you can help anyway possible. Huge thanks for Your help to the community

    Something went wrong

    This dataset includes a dynamic data source. Since dynamic data sources aren’t refreshed in the Power BI service, this dataset won’t be refreshed. Learn more:

    My code is below for your ref

    iterations = 100000, // Number of iterations
    url =
    nxturl = “https://eucenet/web/api/v2.1/installed-applications?limit=1000&ApiToken=af8O9E1ce&cursor=”,

    FnGetOnePage =
    (url) as record =>
    Source = Json.Document(Web.Contents(url)),
    data = try Source[data] otherwise null,
    next = try Source[pagination][nextCursor] otherwise null,
    res = [Data=data, Next=nxturl&next]

    GeneratedList =
    ()=>[i=0, res = FnGetOnePage(url)],
    each [i]<iterations and [res][Data]null,
    each [i=[i]+1, res = FnGetOnePage([res][Next])],
    each [res][Data]),

    #”Converted to Table” = Table.FromList(GeneratedList, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
    #”Expanded Column1″ = Table.ExpandListColumn(#”Converted to Table”, “Column1″)

    #”Expanded Column1”

  43. Hi Chris, Thank you very much for interesting blog post. I have a similar scenario where I am facing refresh issue in Power BI service.
    I am connecting to the Power BI rest API’s, For example I would like to get the dataflows users.
    Below is the power query code and it works fine in desktop version but the refresh is not working in Power BI service as it is a dynamic datasource.
    I followed your recommendation and used Relative path function but still I am facing the issue.
    In the below example, I am passing dataflowId as parameter to the url.

    Source = Dataflows,
    #”Removed Other Columns” = Table.SelectColumns(Source,{“dataflowId”, “dataflowName”}),
    #”Added Custom” = Table.AddColumn(#”Removed Other Columns”, “Custom”, each Json.Document(Web.Contents(“”,
    RelativePath = “dataflows/”& [dataflowId]&”/users”,
    Headers=[Authorization=”Bearer ” & GETAccessToken()]]))),

    #”Expanded Custom” = Table.ExpandRecordColumn(#”Added Custom”, “Custom”, {“value”}, {“value”}),
    #”Expanded value” = Table.ExpandListColumn(#”Expanded Custom”, “value”),
    #”Expanded value1″ = Table.ExpandRecordColumn(#”Expanded value”, “value”, {“dataflowUserAccessRight”, “emailAddress”, “displayName”, “identifier”, “graphId”, “principalType”, “userType”}, {“dataflowUserAccessRight”, “emailAddress”, “displayName”, “identifier”, “graphId”, “principalType”, “userType”})
    #”Expanded value1″

  44. Hi Chris,

    I had this set up successfully for an Azure blob until early 2022.

    The issue seems to be the first section of my path. If i remove the RelativePath then the URL works fine however it then doesn’t refresh. Is this a PowerBI issue or an issue with the first part of the link?

    If i connect to “” on its own then i get an error stating the path does not exist but adding the second part on to the end works so the domain is correct.

    Doesnt work
    Source = Xml.Tables(Web.Contents(“”, [RelativePath=”?restype=container&comp=list&prefix=Datasets/Wholesale/FinalPricing/ClearedOffers/2021″])),

    Does Work (but doesn’t refresh in service)
    Source = Xml.Tables(Web.Contents(“


  45. Hello Chris

    I can’t seem to get this to work. For some reason, Power Query underlines the “api” line of the Query array, and produces an “Invalid Identifier” error. I can change this parameter name to something else like “x” which makes the error move down the the “subscription” parameter (and produces the invalid identifier issue at that point). I can change the subscription-key param to something else as well (like “y”), which doesn’t produce any Power Query validation issues, but has the side effect of not being a valid API call. Do you have any ideas for a work-around?

    Source8 = Json.Document(
    api-version = “1.1”,
    query = 49.246292,-123.116226,
    startDate= StartDate,
    endDate= EndDate,
    subscription-key = “qCJ7My_8PCnBlOsPF6fBSX-8da-749NiDdq-1V9VtgA”

    • The problem is the dash, so you should try
      #”api-version” = “1.1”

      ie, wrap any parameter names that contain problematic characters in double quotes and put a # sign before them. The same goes for #”subscription-key”.

      • Hi Chris,

        Thanks for the post!

        What about having special character in query?

        Is there any way to avoid encode?

        I am using Jira API and sending jql filter as query but contains characters like these +()

        If I use web.contents without relative path and query works fine but not sending it using your method to be able to refresh it



  46. Hello, Fisrt to all I would like to thank you for a blog like this.

    i’ve been tryng to solve an issue to connect to an api, the api has a token that change after 10 minutes.

    Combining this Cris’s powerfull post i was able to ask a token in a function and put it in the web content, the problem is now with de certificates and credentials.

    Once I publish to PowerBIService, It ask me fot credentials that basically dont exist.
    I cant use anonimous and also i dont have other credencials than the token,
    How can i schedule a refresh of this appi??.

    What i;ve done sor far.

    1) ask the token in a function called fxtoken

    () =>
    Origen = Table.FromColumns({Lines.FromBinary(
    ), null, null, 65001)}),

    Column1 = Origen[Column1],

    2)make the query and concatenate with de token,

    Origen = Json.Document(Web.Contents(“”,
    #”Convertida en tabla” = ***lot of stuff***”CORREDOR”, ***lot of stuff*, “PROVINCIAORIGEN”})
    #”Columnas quitadas6″


    I am not a programmer, and i have been am boxing with this a couple of weeks. How can I manage to refresh a api in the service of poerbi??

    Thanks, you all.

  47. Hi Chris,

    Really insightful blog.

    I’m having some issues with the below, are you please able to advise ?

    Source = Json.Document(
    [RelativePath = “/rest/api/2/search?jql=” & QUERY]

    I have two parameters
    JIRA_URL which is internal jira url for the company
    QUERY which is in JQL

    I’m still not able to refresh on Power BI service and getting below error

    This dataset includes a dynamic data source. Since dynamic data sources aren’t refreshed in the Power BI service, this dataset won’t be refreshed. Learn more:

    Would really appreciate your help.

    Thank you,

    Skandar Feki

  48. Hi
    I’m trying to use this method to circumvent this limitation on Power BI service, but it gives me the same famous error (Since dynamic data sources aren’t refreshed in the Power BI service, this dataset won’t be refreshed). I am using OneDrive as data source and this is my query:

    Excel.Workbook(Web.Contents(“”,[RelativePath = “/download”, Query = [resid=”someresourceid”,authkey=”someauthcode”,em=”2″,app=”Excel”]]), null, true)

    Is there anything wrong with this query? I will be very thankful as I’m really stuck with this report.

    • If relative path is working fine in desktop then I would presume your code is correct. However service can’t confirm if a dynamic path is correct so you need to turn on “skip conection” for this datasource. I had a similar issue.I have another comment below with my full code that now works online.

  49. Thanks Chris this blog really helped me solve a dynamic refresh error using an API call to sharepoint. For anyone else who is having issues hear is my code that took a bit of trial and error.Hope this helps anyone.

    I had trouping using relative path aswell however a lot of trial and error led me to the below code that works! Remember to turn off “Test Connection” in powerbi service aswell for this data source. Main Difference is to remove the square bracket at Headers Otherwise you will get a “3 arguments were passed to a function which expects between 1 and 2″ Error. Hope this helps
    //sitename =”examplesitename”,–Variable may work but not tested online
    //listname = “examplelistname”,
    //baseurl = “”,

    // first id and last id to get differance was used as my ids in sharepoint did not go in order and jumped 1000s of ids last id was 21560 but actuals row count was 14000
    lastId =
    [RelativePath = “sites/examplesitename/_api/web/lists/GetByTitle(‘examplelistname’)/items?$top=1&$orderby=ID desc”,Headers=[Accept=”application/json”]]))[value]{0}[ID],

    First_Id =
    [RelativePath = “sites/examplesitename/_api/web/lists/GetByTitle(‘examplelistname’)/items?$top=1&$orderby=ID asc”,Headers=[Accept=”application/json”]]))[value]{0}[ID]-1,

    diff =lastId – First_Id,

    skiplist = List.Numbers(First_Id, Number.RoundUp(diff/5000), 5000),
    #”Convert to Table” = Table.FromList(skiplist,Splitter.SplitByNothing(),null,null,ExtraValues.Error),
    #”Renamed Columns” = Table.RenameColumns(#”Convert to Table”,{{“Column1”, “skip”}}),
    #”Changed Type” = Table.TransformColumnTypes(#”Renamed Columns”,{{“skip”, type text}}),
    fieldselect =”&$top=5000″,

    #”Added Custom” =Table.AddColumn(#”Changed Type”, “Items”, each
    [RelativePath = “sites/examplesitename/_api/web/lists/GetByTitle(‘examplelistname’)/items?$skipToken=Paged=TRUE%26p_ID=” & [skip] & fieldselect, Headers=[Accept=”application/json”]]))),
    #”Expanded Items1″ = Table.ExpandRecordColumn(#”Added Custom”, “Items”, {“value”}, {“value”}),
    #”Expanded value” = Table.ExpandListColumn(#”Expanded Items1″, “value”),
    #”Expanded value1″ = Table.ExpandRecordColumn(#”Expanded value”, “value”, {“odata.type”, “”, “odata.etag”, “odata.editLink”, “FileSystemObjectType”, “Id”,”GUID”}),
    #”Removed Duplicates” = Table.Distinct(#”Expanded value1″, {“ID”}),
    #”Removed Columns” = Table.RemoveColumns(#”Removed Duplicates”,{“skip”, “odata.type”, “”, “odata.etag”, “odata.editLink”}),

    #”Removed Columns”

Leave a Reply to Mohammad Javahery Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: