> ## Documentation Index > Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Headings For List Item From List Name > Gets a selectable MDO list of the headings for this list item NsApiSlow threshold: 5000 ms. ## OpenAPI ````yaml /openapi/agent/openapi-v3-ListAgent.json post /api/v1/Agents/List/GetHeadingsForListItemFromListName openapi: 3.0.0 info: version: v1-Agents title: SuperOffice Agent API v1 description: SuperOffice Agent API - ListAgent contact: name: SuperOffice DevNet url: https://docs.superoffice.com/en/api/index.html email: sdk@superoffice.com servers: - url: http://localhost:56350 - url: https://localhost:56350 security: [] tags: [] externalDocs: description: >- The SuperOffice DevNet Community has more documentation, examples, and discussion forums. url: https://community.superoffice.com/en/developer/ paths: /api/v1/Agents/List/GetHeadingsForListItemFromListName: post: tags: - List_Agent summary: Get Headings For List Item From List Name description: |- Gets a selectable MDO list of the headings for this list item NsApiSlow threshold: 5000 ms. operationId: v1ListAgent_GetHeadingsForListItemFromListName parameters: - name: $select in: query description: >- Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields. required: false schema: type: string - name: Accept-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. required: false schema: type: string - name: SO-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. required: false schema: type: string - name: SO-Culture in: header description: >- Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. required: false schema: type: string - name: SO-TimeZone in: header description: >- Specify the timezone code that you would like date/time responses converted to. required: false schema: type: string - name: SO-AppToken in: header description: >- The application token that identifies the partner app. Used when calling Online WebAPI from a server. required: false schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest text/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest application/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest text/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest application/json-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest application/merge-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest description: UdListDefinitionName, ListItemId, ShowDeleted required: true responses: '200': description: OK content: application/json: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem text/json: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem application/xml: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem text/xml: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem application/json-patch+json: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem application/merge-patch+json: schema: type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.WebApi.v1.Carriers.ListCarriers.GetHeadingsForListItemFromListNameRequest: description: >- GetHeadingsForListItemFromListName: Gets a selectable MDO list of the headings for this list item type: object properties: UdListDefinitionName: type: string ListItemId: format: int32 type: integer ShowDeleted: type: boolean SuperOffice.CRM.Services.SelectableMDOListItem: description: "Carrier object for SelectableMDOListItem.\r\nServices for the SelectableMDOListItem Carrier is available from the MDO Agent." type: object properties: Id: format: int32 description: The Id of the ListItem type: integer Name: description: The name of the ListItem type: string ToolTip: description: The tooltip of the ListItem type: string Deleted: description: The deleted status of the ListItem type: boolean Rank: format: int32 description: The rank of the ListItem type: integer Type: description: The type of the ListItem. Custom field. type: string ColorBlock: format: int32 description: The color indicator of the ListItem color block type: integer IconHint: description: The Icon hint of the ListItem. Custom field. type: string Selected: description: True if the ListItem is selected type: boolean LastChanged: format: date-time description: Time of last change. type: string ChildItems: description: The child items of the SelectableMDOListItem type: array items: $ref: >- #/components/schemas/SuperOffice.CRM.Services.SelectableMDOListItem ExtraInfo: description: >- Extra information added to the ListItem. Could be information such as sort order etc or other meta data. Custom field. type: string StyleHint: description: >- Style hint indicating, information such as background color etc. Custom field. type: string Hidden: description: True if the ListItem is hidden type: boolean FullName: description: The name of the ListItem in its context type: string TableRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight' FieldProperties: description: >- Field property dictionary mapping field names to field access rights. type: object additionalProperties: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty' SuperOffice.CRM.Security.TableRight: description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted." type: object properties: Mask: type: string Reason: type: string SuperOffice.CRM.Security.FieldProperty: description: >- Class holding properties like field length, field type about a field in the carrier. type: object properties: FieldRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight' FieldType: type: string FieldLength: format: int32 description: '' type: integer SuperOffice.CRM.Security.FieldRight: description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined." type: object properties: Mask: type: string Reason: type: string ```` ## Related topics - [Get Headings For List Item From List Name](/en/api/reference/restful/rest/list_item/get-headings-for-list-item-from-list-name.md) - [Get List Items For Heading From List Name](/en/api/reference/restful/agent/list_agent/get-list-items-for-heading-from-list-name.md) - [Get List Items For Heading](/en/api/reference/restful/agent/list_agent/get-list-items-for-heading.md) - [List headings](/en/admin/lists/headings.md) - [Get Task List Item Headings For List Item](/en/api/reference/restful/rest/list_task/get-task-list-item-headings-for-list-item.md) - [Get Priority Headings For List Item](/en/api/reference/restful/rest/list_priority/get-priority-headings-for-list-item.md)