# List fields

`GET /v1/userfields/tasks`

Bitrix24 method: `task.item.userfield.getlist`. Scope: `task`.

Filters: `userTypeId`, `fieldName`, `lang`. Label language defaults to the key language or `ru`. Response: `{success:true,data:[...],meta:{total}}`. total is the array length; there is no pagination. Enumeration variants are in `items`, including `id`, `value`, `sort`, `def`, `xmlId`. System fields have `system:true`.

## Errors and access

Missing scope: `403 SCOPE_DENIED`. Portal plan without TASK_CUSTOM_FIELDS: `403 TASK_CUSTOM_FIELDS_UNAVAILABLE`, including reads. Nonexistent fields: `404 ENTITY_NOT_FOUND`. Invalid input: `400`; Bitrix24 business refusals: `422`. Bitrix24 write permission refusals: `403`. Reads accept READONLY keys; writes require READWRITE and portal administrator rights. Writes are never retried automatically. After a timeout, the outcome is unknown: reread the field before another write.

[All task field operations](/docs/userfields/tasks)