GET {clientId}/Picklists?Id={Id}&locale={locale}
This method will retrieve all Picklists defined by the client, unless you specify a Picklist Id, which will return only that Picklist. Optionally you can include a locale to filter the results by a specific locale.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
clientId |
This is your organization’s MyPreferences Account Id. |
string |
Required |
Id |
Custom PicklistId. If specified, only the picklist with this Id will be returned. |
integer |
Default value is 0 |
locale |
A valid locale associated with the picklist type. Ex: “en”, “en-us”, “en-uk”, “fr-ca”. |
string |
Body Parameters
None.
Response Information
Response Codes
HTTP Status Code | Text | Description |
---|---|---|
200 | OK | The request was successfully processed. |
400 | Bad Request | The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again. |
401 | Unauthorized | Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again. |
403 | Forbidden | The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again. |
500 | Internal Server Error | The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence. |
Resource Description
PicklistListName | Description | Type | Additional information |
---|---|---|---|
Picklists |
A collection of Picklists that can be associated with a Profile |
Collection of Picklist |
Response Formats
application/json, text/json, application/json-patch+json
Sample:
{ "Picklists": [ { "Id": 1, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Name": "sample string 2", "Description": "sample string 3", "IsActive": true, "FieldSelectOptions": [ { "LocalizedFieldSelectOptions": [ { "Locale": "sample string 1", "DisplayText": "sample string 2" }, { "Locale": "sample string 1", "DisplayText": "sample string 2" } ], "Value": "sample string 1", "DisplayOrder": 2, "IsDefault": true, "IsActive": true }, { "LocalizedFieldSelectOptions": [ { "Locale": "sample string 1", "DisplayText": "sample string 2" }, { "Locale": "sample string 1", "DisplayText": "sample string 2" } ], "Value": "sample string 1", "DisplayOrder": 2, "IsDefault": true, "IsActive": true } ] }, { "Id": 1, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Name": "sample string 2", "Description": "sample string 3", "IsActive": true, "FieldSelectOptions": [ { "LocalizedFieldSelectOptions": [ { "Locale": "sample string 1", "DisplayText": "sample string 2" }, { "Locale": "sample string 1", "DisplayText": "sample string 2" } ], "Value": "sample string 1", "DisplayOrder": 2, "IsDefault": true, "IsActive": true }, { "LocalizedFieldSelectOptions": [ { "Locale": "sample string 1", "DisplayText": "sample string 2" }, { "Locale": "sample string 1", "DisplayText": "sample string 2" } ], "Value": "sample string 1", "DisplayOrder": 2, "IsDefault": true, "IsActive": true } ] } ] }
application/xml, text/xml
Sample:
<PicklistList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ProfileServices.REST.Models"> <Picklists> <Picklist> <Description>sample string 3</Description> <FieldSelectOptions> <FieldSelectOption> <DisplayOrder>2</DisplayOrder> <IsActive>true</IsActive> <IsDefault>true</IsDefault> <LocalizedFieldSelectOptions> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> </LocalizedFieldSelectOptions> <Value>sample string 1</Value> </FieldSelectOption> <FieldSelectOption> <DisplayOrder>2</DisplayOrder> <IsActive>true</IsActive> <IsDefault>true</IsDefault> <LocalizedFieldSelectOptions> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> </LocalizedFieldSelectOptions> <Value>sample string 1</Value> </FieldSelectOption> </FieldSelectOptions> <IsActive>true</IsActive> <Name>sample string 2</Name> <Edited> <CreateDate>sample string 1</CreateDate> <CreatedBy>sample string 2</CreatedBy> <ModifiedBy>sample string 4</ModifiedBy> <ModifiedDate>sample string 3</ModifiedDate> </Edited> <Id>1</Id> </Picklist> <Picklist> <Description>sample string 3</Description> <FieldSelectOptions> <FieldSelectOption> <DisplayOrder>2</DisplayOrder> <IsActive>true</IsActive> <IsDefault>true</IsDefault> <LocalizedFieldSelectOptions> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> </LocalizedFieldSelectOptions> <Value>sample string 1</Value> </FieldSelectOption> <FieldSelectOption> <DisplayOrder>2</DisplayOrder> <IsActive>true</IsActive> <IsDefault>true</IsDefault> <LocalizedFieldSelectOptions> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> <LocalizedFieldSelectOption> <DisplayText>sample string 2</DisplayText> <Locale>sample string 1</Locale> </LocalizedFieldSelectOption> </LocalizedFieldSelectOptions> <Value>sample string 1</Value> </FieldSelectOption> </FieldSelectOptions> <IsActive>true</IsActive> <Name>sample string 2</Name> <Edited> <CreateDate>sample string 1</CreateDate> <CreatedBy>sample string 2</CreatedBy> <ModifiedBy>sample string 4</ModifiedBy> <ModifiedDate>sample string 3</ModifiedDate> </Edited> <Id>1</Id> </Picklist> </Picklists> </PicklistList>