---
schema_version: "1"
id: 29c8a150c91966d5c827629112ad607343d156d1dbaf417dabbb59b077cc4dfe
title: Retrieve the Versions of Picklists
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/industries/cme/guides/comms-t-retrieve-the-versions-of-picklists.md
canonical_url: https://developer.salesforce.com/docs/industries/cme/guide/comms-t-retrieve-the-versions-of-picklists.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9425a5ef646504fa0e9538ac919051b61faf36dc5e624f7a277e11d5fd7cc482
products:
  - Communications, Media, Energy and Utilities APIs (Managed Package)
  - Industries Developer Documentation
---
# Retrieve the Versions of Picklists

Retrieve the versions of picklists using REST APIs by specifying the ID of the picklist in the resource URI.

```nolang
GET /v2/epc/picklists/{picklist-ID}/versions
```

## Remote Method

```nolang
readPicklist
```

## REST Handler

```nolang
APIPicklistVersionRestHandler
```

## Apex Remote Service

```nolang
PCAppHandler
```

## Package

Communication (vlocity_cmt)

## API Parameters and Response Format

For API parameter names and descriptions, see the [Swagger (OpenAPI) reference documentation for Industries EPC REST APIs](https://developer.salesforce.com/docs/industries/cme/references/epc?meta=Summary).


## Resource Information

| Response Format | JSON                                                                   |
| --------------- | ---------------------------------------------------------------------- |
| Resource URL    | /services/apexrest/{namespace}/v2/epc/picklists/{picklist-id}/versions |

## Example Request

```nolang
GET /v2/epc/picklists/01t3h000001gyCFAAY/versions

```

## Example Result

```
{
    "epcResponse": {
        "entities": [
            {
                "supplimentryEntity": [
                    {
                        "attributes": {
                            "type": "Picklist2",
                            "url": "/services/data/v52.0/sobjects/Picklist2/01t3h000001gyCFAAY"
                        },
                        "vlocity_cmt__VersionLabel__c": "Version-1",
                        "Name": "Picklist-Ashish",
                        "PicklistCode": "Picklist-Ashish",
                        "vlocity_cmt__SpecificationType__c": "Offer",
                        "vlocity_cmt__SpecificationSubType__c": "Bundle",
                        "vlocity_cmt__LifecycleStatus__c": "Draft",
                        "vlocity_cmt__GlobalGroupKey__c": "a4096cc5-8bbb-cfd5-7b93-869a7c2b4caf",
                        "RecordTypeId": "0123h000000slEnAAI",
                        "Id": "01t3h000001gyCFAAY",
                        "RecordType": {
                            "attributes": {
                                "type": "RecordType",
                                "url": "/services/data/v52.0/sobjects/RecordType/0123h000000slEnAAI"
                            },
                            "Id": "0123h000000slEnAAI",
                            "Name": "Picklist"
                        }
                    },
                    {
                        "attributes": {
                            "type": "Picklist2",
                            "url": "/services/data/v52.0/sobjects/Picklist2/01t3h000001h1uxAAA"
                        },
                        "vlocity_cmt__VersionLabel__c": "Version-2",
                        "Name": "Picklist-Ashish",
                        "PicklistCode": "Picklist-Ashish",
                        "vlocity_cmt__SpecificationType__c": "Offer",
                        "vlocity_cmt__SpecificationSubType__c": "Bundle",
                        "vlocity_cmt__LifecycleStatus__c": "Draft",
                        "vlocity_cmt__GlobalGroupKey__c": "a4096cc5-8bbb-cfd5-7b93-869a7c2b4caf",
                        "RecordTypeId": "0123h000000slEnAAI",
                        "Id": "01t3h000001h1uxAAA",
                        "RecordType": {
                            "attributes": {
                                "type": "RecordType",
                                "url": "/services/data/v52.0/sobjects/RecordType/0123h000000slEnAAI"
                            },
                            "Id": "0123h000000slEnAAI",
                            "Name": "Picklist"
                        }
                    }
                ],
                "entity": {
                    "attributes": {
                        "type": "Picklist2",
                        "url": "/services/data/v52.0/sobjects/Picklist2/01t3h000001gyCFAAY"
                    },
                    "vlocity_cmt__VersionLabel__c": "Version-1",
                    "Name": "Picklist-Ashish",
                    "PicklistCode": "Picklist-Ashish",
                    "vlocity_cmt__SpecificationType__c": "Offer",
                    "vlocity_cmt__SpecificationSubType__c": "Bundle",
                    "vlocity_cmt__LifecycleStatus__c": "Draft",
                    "vlocity_cmt__GlobalGroupKey__c": "a4096cc5-8bbb-cfd5-7b93-869a7c2b4caf",
                    "RecordTypeId": "0123h000000slEnAAI",
                    "Id": "01t3h000001gyCFAAY",
                    "RecordType": {
                        "attributes": {
                            "type": "RecordType",
                            "url": "/services/data/v52.0/sobjects/RecordType/0123h000000slEnAAI"
                        },
                        "Id": "0123h000000slEnAAI",
                        "Name": "Picklist"
                    }
                }
            }
        ],
        "overallResult": "success"
    }
}

```