# /smartlists/{smartListId}

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Formstack API v2025.0",
    "version": "0.0.4"
  },
  "servers": [
    {
      "url": "https://www.formstack.com/api/v2025",
      "description": "Production server"
    },
    {
      "url": "https://staging-formstack.com/api/v2025",
      "description": "Staging server"
    },
    {
      "url": "https://dev-formstack.com/api/v2025",
      "description": "Development server"
    }
  ],
  "paths": {
    "/smartlists/{smartListId}": {
      "get": {
        "tags": [
          "Smart List"
        ],
        "operationId": "getSmartList",
        "parameters": [
          {
            "name": "smartListId",
            "in": "path",
            "description": "ID of the smart list to retrieve",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SmartList details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SmartListDetailedApiDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "SmartList not found"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SmartListDetailedApiDto": {
        "title": "Smart List Details",
        "description": "Smart List details response",
        "properties": {
          "id": {
            "description": "The ID of the smart list",
            "type": "integer",
            "nullable": false
          },
          "name": {
            "description": "Name of the smart list",
            "type": "string",
            "nullable": false
          },
          "useImages": {
            "description": "Whether the smart list uses images",
            "type": "boolean",
            "nullable": false
          },
          "useSeparateValues": {
            "description": "Whether the smart list uses separate values",
            "type": "boolean",
            "nullable": false
          },
          "created": {
            "description": "Date when the smart list was created (ISO 8601 format)",
            "type": "string",
            "format": "date-time",
            "example": "2023-12-01T10:30:00Z",
            "nullable": false
          },
          "updated": {
            "description": "Date when the smart list was last updated (ISO 8601 format)",
            "type": "string",
            "format": "date-time",
            "example": "2023-12-01T15:45:00Z",
            "nullable": false
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Smart List",
      "description": "Smart Lists are reusable sets of options that can be shared across fields and forms, so option sets are maintained in one place rather than per field. Use these endpoints to list smart lists and to create, retrieve, update, and delete a smart list."
    }
  ]
}
```