Full name: projects.locations.instances.referenceLists.list
Lists a collection of reference lists.
HTTP request
Path parameters
Parameters
parent
string
Required. The parent, which owns this collection of reference lists. Format: projects/{project}/locations/{location}/instances/{instance}
Query parameters
Parameters
pageSize
integer
The maximum number of reference lists to return. The service may return fewer than this value. If unspecified, at most 100 reference lists will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
A page token, received from a previous referenceLists.list call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to referenceLists.list must match 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-08-25 UTC."],[[["\u003cp\u003eThis API endpoint \u003ccode\u003eprojects.locations.instances.referenceLists.list\u003c/code\u003e retrieves a collection of reference lists from a specified parent resource.\u003c/p\u003e\n"],["\u003cp\u003eThe request is a \u003ccode\u003eGET\u003c/code\u003e HTTP method to the URL \u003ccode\u003ehttps://chronicle.googleapis.com/v1alpha/{parent}/referenceLists\u003c/code\u003e, and requires a parent path parameter in the format \u003ccode\u003eprojects/{project}/locations/{location}/instances/{instance}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the number of reference lists returned using the \u003ccode\u003epageSize\u003c/code\u003e query parameter (up to 1000), and utilize pagination with the \u003ccode\u003epageToken\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003ereference_lists\u003c/code\u003e and a \u003ccode\u003enext_page_token\u003c/code\u003e for further pagination, and each list is ordered in ascending alphabetical order by name.\u003c/p\u003e\n"],["\u003cp\u003eAccess to this API requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003echronicle.referenceLists.list\u003c/code\u003e on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: referenceLists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListReferenceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\n**Full name**: projects.locations.instances.referenceLists.list\n\nLists a collection of reference lists.\n\n### HTTP request\n\nChoose a location: \nafrica-south1 asia-northeast1 asia-south1 asia-southeast1 asia-southeast2 australia-southeast1 europe-west12 europe-west2 europe-west3 europe-west6 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast2 southamerica-east1 us eu \n\n\u003cbr /\u003e\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response to a request for a list of reference lists.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `chronicle.referenceLists.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]