> ## Documentation Index > Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Document Lists > Retrieve a paged documentListName of all document lists ## OpenAPI ````yaml /openapi/openapi_content.json get /content/documentlists openapi: 3.0.1 info: description: |-

CONTENT

The Content APIs allow you to organize your site content into a hierarchy of folders and documents, as well as control the publishing of your content to the live site with publish sets that group pending changes together to publish at the same time. For more information about managing site content and the associated UI, see the Site Builder and Publishing user guides.

Use the Document Lists and Document List Types resources to organize your site's documents into a hierarchy. Document lists can contain documents, folders, and complete hierarchies of folders, which contain documents with unique names. The type denotes a content type for that list of folders, sub-folders, and documents such as `web_pages`.

Use the Document Types and Document Property Types resources to manage the document and property types supported by the Content API.

Use the Document Publishing resource to manage and publish document drafts. The related Document Publish Set resource manages publish sets and the pending content drafts.

title: Content version: 0.0.1 servers: - description: Kibo Base URL url: '{baseUrl}/api' variables: baseUrl: default: https://t1000000.sb.usc1.gcp.kibocommerce.com description: Base URL security: - bearerAuth: [] paths: /content/documentlists: get: tags: - DocumentList summary: Get Document Lists description: Retrieve a paged documentListName of all document lists parameters: - description: maximum number of items to return in: query name: pageSize schema: format: int32 type: integer - description: '' in: query name: startIndex schema: format: int32 type: integer - description: limits which fields are returned in the response body in: query name: responseFields schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/DocumentListCollection' text/json: schema: $ref: '#/components/schemas/DocumentListCollection' text/plain: schema: $ref: '#/components/schemas/DocumentListCollection' description: Success components: schemas: DocumentListCollection: properties: items: items: $ref: '#/components/schemas/DocumentList' nullable: true type: array pageCount: format: int32 type: integer pageSize: format: int32 type: integer startIndex: format: int32 type: integer totalCount: format: int32 type: integer type: object DocumentList: description: "A container for documents and related settings, such as supported documentTypes and publishing. \r\nA documentList belongs to a Mozu context, denoted by the documentList scopyeType and scopeId fields. \r\nExample: documentList A belongs to catalog 123, denoted by the documentList scopeType value of catalog and scopeId value of 123.\r\nA documentList can only be accessed if the API context is inclusive of the documentList's scope.\r\nExample: documentList A belongs to catalog 123. An API call with an API context of catalog 123 will be able to address documentList A.\r\nExample: site 456 uses catalog 123. An API call with an API context of site 456 will be able to address documentList A.\r\nExample: masterCatalog 789 is the parent of catalog 123. An API call with an API context of masterCatalog 789 will NOT be able to address documentList A.\r\nDocuments can be created, queried, managed and published from within a documentList. A documentList may be directly created, or indirectly created from a documentListType." properties: documentListType: description: "The full name of the documentListType (name@namespace) that underlies the documentList. This value is only populated when the Mozu platform creates a documentList from a documentListType.\r\nA documentList that is directly created cannot specify a documentListType. This field is therefore read-only." nullable: true type: string documentTypes: description: "An array of the full names (name@namespace) of the documentTypes supported by the documentList. A document in the documentList must belong to one of these documentTypes.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType. DocumentTypes can be added/removed to the documentList, even when\r\nbased on a documentListType. Existing documents that belong to a documentType removed from the documentList will not be removed." items: type: string nullable: true type: array enableActiveDateRanges: description: "Determines if the documentList has ActiveDateRanges turned on or off. If the documentList has a supportsActiveDateRanges value of true, then the enableActiveDateRanges value will be honored.\r\nIf enableActiveDateRanges is true, then a document will only be returned if the request is made within the time frame the document has been set to be 'active'.\r\nIf enableActiveDateRanges is false, then the properties can be set but will not be honored.\r\nIf enableActiveDateRanges is true, then updating it to false will immediately start honoring the previously-set date range.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType, but can be overridden on update." nullable: true type: boolean enablePublishing: description: "Determines if the documentList has publishing turned on or off. If the documentList has a supportsPublishing value of true, then the enablePublishing value will be honored.\r\nIf enablePublishing is true, then a document draft will be created for a document create or update operation. A document must then be published to become \"active\".\r\nIf enablePublish is false, then all document changes are immediately \"active\".\r\nIf enablePublish is true, then updating it to false will immediately publish all draft changes.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType, but can be overridden on update." nullable: true type: boolean listFQN: description: "The unique identifier of the documentList, represented by name@namespace. The listFQN must be provided when creating the documentList, or the name and namespace fields must be provided.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType." nullable: true type: string metadata: description: "Allows arbitrary data to be stored on the documentList.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType, but can be overridden on update." nullable: true name: description: "The name component of the listFQN, name@namespace. The name must be unique within the namespace component and cannot be updated.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType." nullable: true type: string namespace: description: "The namespace component of the listFQN, name@namespace. The issued dev account namespace must be used unless elevated privileges allow a blank namespace to be used. The namespace cannot be updated.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType." nullable: true type: string scopeId: description: "Used in conjunction with the scopeType field to determine the exact context within which the documentList resides.\r\nExample: A documentList with a scopeId of 5 and scopeType of masterCatalog belongs to masterCatalog 5.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType. This value is read-only after the documentList is created." format: int32 nullable: true type: integer scopeType: description: "The context level the documentList resides in. Valid values are \"tenant\", \"masterCatalog\", \"catalog\" and \"site\". This field is used in conjunction with the scopeId field\r\nto determine the exact context within which this documentList resides. This field is read-only after insert.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType. This value is read-only after the documentList is created." nullable: true type: string security: description: tbd nullable: true type: string supportsActiveDateRanges: description: "Determines if the documentList will support ranges of dates that documents are considered 'active'. \r\nThis field defaults to false and cannot be updated.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType." nullable: true type: boolean supportsPublishing: description: "Determines if the documentList will support drafting and publishing documents. \r\nThis field defaults to false and cannot be updated.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType." nullable: true type: boolean usages: description: "An array of strings that describes to the Mozu platform the manner(s) in which a documentList can be used. The following values are valid:\r\nentitymanager -- the documentList should be visible in the Admin Content/Entities UI, which allows admin users to create, manage and publish documents within the documentList.\r\nsitebuilder -- the documentList should be visible in Site Builder. A documentList will display in the Site Builder Navigation Content List node, which supports document creation, management and web cms integration.\r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType. Usages can be added or removed from the documentList, even when the documentList derives from a\r\ndocumentListType." items: type: string nullable: true type: array views: description: "An array of one or more views, which each allow GET access to a projection of fields from the documents in the given documentList. \r\nIf the documentList is based on a documentListType, then this value will be derived from the documentListType. Views can be added/removed to the documentList, even when\r\nthe documentList derives from a documentListType." items: $ref: '#/components/schemas/View' nullable: true type: array type: object View: description: "A view provides GET access to documents within the documentList the view belongs to. The view can designate which document fields are returned (projection) and\r\na security model for providing GET access independent of the documentList's security model." properties: fields: description: >- Designation of which document fields are returned (projection) when GETing documents from the view. items: $ref: '#/components/schemas/ViewField' nullable: true type: array filter: description: "Filter criteria to apply automatically when documents from this view are accessed, using the standard Mozu filter syntax. Only documents matching the filter criteria will be returned. \r\nAny filter provided by an operation is combined with the view filter." nullable: true type: string includeInactiveMode: description: "If view documents are requested with includeInactive=true, then this controls which documents return. If includeInactive is not provided or set to false, then only active documents return.\r\nIf not set, or set to \"all\", then all documents return.\r\nIf set to \"active\", then only documents within the active date range and documents with no active date range are returned.\r\nIf set to \"scheduled\", then only documents with an active date range in the future are returned.\r\nIf set to \"activeOrScheduled\", then only documents that are active or documents with an active date range in the future are returned.\r\nIf set to \"ended\", then only documents with an active date range in the past are returned." nullable: true type: string isAdminDefault: nullable: true type: boolean isVisibleInStorefront: description: "The isVisibleInStorefront field indicates whether documents in the view can be accessed from the Mozu storefront application. If true, the storefront application and storefront client application (javascript tier) \r\ncan GET documents from the view." nullable: true type: boolean metadata: description: The metadata field allows arbitrary data to be stored on the view. nullable: true name: description: >- A view is addressed via its name, which is unique within the documentList or documentListType in which it is defined. nullable: true type: string usages: description: tbd items: type: string nullable: true type: array type: object ViewField: description: The projection of an individual field in a view. properties: name: description: "The name of the field projected into the view document, meaning the name given to the target field after it is projected.\r\nThe name must be unique within the list of viewFields provided in the view." nullable: true type: string target: description: "Specifies the document field to project. First-class fields will be returned on the document, but can be projected into the view properties. \r\nValid first-class fields include name, id, documentTypeFqn, listFqn and publishState. Dynamic fields within the properties field can be projected by prefixing the target string with \"properties.\"\r\nExample: \"properties.property1\". If a property is an object, then dot notation can be used to walk to particular subelements. Example: \"properties.property1.subProperty1\"\r\nIndividual array elements can be selected as well. Example: \"properties.property1.subProperty1.subSubArray[2].propertyOnArrayItem\"\r\nAny target miss will result in a null value returning for the projected field." nullable: true type: string type: object securitySchemes: bearerAuth: bearerFormat: JWT description: JWT Authorization header using the Bearer scheme. scheme: bearer type: http ````