---
title: Define List
slug: define-list
docTags: 
createdAt: 2022-11-25T15:15:31.000Z
---

Defines Properties of a list element. The currently supported properties are

| Definition | Description                                |
| ---------- | ------------------------------------------ |
| length     | The number of items in the given JSON list |



### API Definition

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://orca.pathfix.com/functions/list/define",
  "name": "Define List API",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "28UsDqyeH3QRdmtVamSQT",
        "code": "{\n\t\"output\": {\n\t\t\"length\":3\n\t}\n}",
        "language": "200"
      },
      {
        "id": "yIX64DyIuDPJgBRFSfAWb",
        "code": "{\n    \"message\": \"error\"\n}",
        "language": "404"
      }
    ],
    "selectedLanguageId": "28UsDqyeH3QRdmtVamSQT"
  },
  "examples": {
    "languages": [
      {
        "id": "ENcJz9TStG38F0X-taA4x",
        "code": "{\r\n\t\"input\": [\r\n\t\t{\r\n\t\t\t\"user_id\": \"bruce@pathfix.com\"\r\n\t\t},\r\n\t\t{\r\n\t\t\t\"user_id\": \"paul@pathfix.com\"\r\n\t\t},\r\n\t\t{\r\n\t\t\t\"user_id\": \"chang@pathfix.com\"\r\n\t\t}\r\n\t]\r\n}",
        "language": "json"
      }
    ],
    "selectedLanguageId": "ENcJz9TStG38F0X-taA4x"
  },
  "description": "\nCall the following API:",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  }
}
```
:::