Lists runs in the given project and location. List order is descending by startTime.
HTTP request
GET https://datalineage.googleapis.com/v1/{parent}/runs
Path parameters
Parameters
parent
string
Required. The name of process that owns this collection of runs. It takes the form projects/{project}/locations/{location}/processes/{processes}.
Query parameters
Parameters
pageSize
integer
The maximum number of runs to return. The service may return fewer than this value. If unspecified, at most 50 runs are returned. The maximum value is 100; values greater than 100 are cut to 100.
pageToken
string
The page token received from a previous runs.list call. Specify it to get the next page.
When paginating, all other parameters specified in this call must match the parameters of the call that provided the page token.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-21 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of runs within a specified project and location, ordered in descending order by \u003ccode\u003estartTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://datalineage.googleapis.com/v1/{parent}/runs\u003c/code\u003e requires a \u003ccode\u003eparent\u003c/code\u003e path parameter to identify the process that owns the runs.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters, \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e, are used to manage pagination, allowing you to control the number of runs returned per request and navigate through multiple pages of results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response includes an array of \u003ccode\u003eruns\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this API requires the \u003ccode\u003edatalineage.runs.list\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]