---
title: "REST API – Drop-down lists (Picklist)"
description: "--- ## GetPicklistValues — Retrieve values Retrieves the list of available values for a drop-down list (picklist) field in a module. > **GET** `https://apps.kafinea.com/{instance}/webservice.php` | Parameter | Type | Required | Description | | --- | --- | --- |…"
url: "https://www.kafinea.com/en/help/api/rest-api-drop-down-lists-picklist/"
updated: "2026-04-03"
category: API
---

# REST API – Drop-down lists (Picklist)

---

## GetPicklistValues — Retrieve values

Retrieves the list of available values for a drop-down list (picklist) field in a module.

> **GET** `https://apps.kafinea.com/{instance}/webservice.php`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `operation` | string | yes | Must be `getPicklistValues` |
| `sessionName` | string | yes | Session ID |
| `moduleName` | string | yes | Module name (e.g.: `Accounts`, `Leads`) |
| `fieldName` | string | yes | Field technical name |

**curl example:**

```bash
curl "https://apps.kafinea.com/YourKafinea/webservice.php?operation=getPicklistValues&sessionName=YOUR_SESSION_ID&moduleName=Accounts&fieldName=industry"
```

---

## SetPicklistValues — Edit values

Updates the list of available options for a drop-down list field.

> **⚠️ Warning!** This operation **replaces all** existing values with the provided list. Any old values not included in the new list will be lost.

> **POST** `https://apps.kafinea.com/{instance}/webservice.php`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `operation` | string | yes | Must be `setPicklistValues` |
| `sessionName` | string | yes | Session ID |
| `moduleName` | string | yes | Name of the relevant module |
| `fieldName` | string | yes | Technical name of the field to edit |
| `values` | JSON | yes | JSON array of the new options (e.g.: `["Banque", "Tech"]`) |

**curl example:**

```bash
curl -X POST https://apps.kafinea.com/YourKafinea/webservice.php 
  -d "operation=setPicklistValues" 
  -d "sessionName=YOUR_SESSION_ID" 
  -d "moduleName=Accounts" 
  -d "fieldName=industry" 
  -d 'values=["Banque","Tech","Santé"]'
```

---

## Related references 🔗

- [CRUD operations](https://www.kafinea.com/en/documentation/api/rest-api-crud-operations/)
- [API introduction](https://www.kafinea.com/en/documentation/api/rest-api-introduction/)