---
updatedAt: 2026-08-06T21:05:39.000Z
agentTools:
  projectIndex: https://snipe-it.readme.io/llms.txt
---

# /fieldsets/:id

Return fieldset info by id

Please see the documentation on [Custom Fields and Fieldsets](https://snipe-it.readme.io/docs/custom-fields) and [Updating Custom Fields via API](https://snipe-it.readme.io/reference/updating-custom-fields) for more information on how custom fields work.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "snipe-it-rest-api",
    "version": "8.2.0"
  },
  "servers": [
    {
      "url": "https://develop.snipeitapp.com/api/v1"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/fieldsets/{id}": {
      "get": {
        "summary": "/fieldsets/:id",
        "description": "Return fieldset info by id",
        "operationId": "fieldsetsid",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "The ID number of the fieldset",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"id\": 1,\n  \"name\": \"Asset with MAC Address\",\n  \"fields\": {\n    \"total\": 1,\n    \"rows\": [\n      {\n        \"name\": \"Quality-focused local GraphicalUserInterface\",\n        \"db_column_name\": \"_snipeit_quality_focused_local_graphicaluserinterf_2\",\n        \"format\": \"IP\",\n        \"required\": 0,\n        \"created_at\": {\n          \"datetime\": \"2017-10-30 21:00:42\",\n          \"formatted\": \"Mon Oct 30, 2017 9:00PM\"\n        },\n        \"updated_at\": {\n          \"datetime\": \"2017-10-30 21:00:42\",\n          \"formatted\": \"Mon Oct 30, 2017 9:00PM\"\n        }\n      }\n    ]\n  },\n  \"models\": {\n    \"total\": 0,\n    \"rows\": []\n  },\n  \"created_at\": null,\n  \"updated_at\": null\n}"
                  },
                  "Not Found": {
                    "value": "{\n  \"status\": \"error\",\n  \"messages\": \"Fieldset not found\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer",
                          "example": 1,
                          "default": 0
                        },
                        "name": {
                          "type": "string",
                          "example": "Asset with MAC Address"
                        },
                        "fields": {
                          "type": "object",
                          "properties": {
                            "total": {
                              "type": "integer",
                              "example": 1,
                              "default": 0
                            },
                            "rows": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "name": {
                                    "type": "string",
                                    "example": "Quality-focused local GraphicalUserInterface"
                                  },
                                  "db_column_name": {
                                    "type": "string",
                                    "example": "_snipeit_quality_focused_local_graphicaluserinterf_2"
                                  },
                                  "format": {
                                    "type": "string",
                                    "example": "IP"
                                  },
                                  "required": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "created_at": {
                                    "type": "object",
                                    "properties": {
                                      "datetime": {
                                        "type": "string",
                                        "example": "2017-10-30 21:00:42"
                                      },
                                      "formatted": {
                                        "type": "string",
                                        "example": "Mon Oct 30, 2017 9:00PM"
                                      }
                                    }
                                  },
                                  "updated_at": {
                                    "type": "object",
                                    "properties": {
                                      "datetime": {
                                        "type": "string",
                                        "example": "2017-10-30 21:00:42"
                                      },
                                      "formatted": {
                                        "type": "string",
                                        "example": "Mon Oct 30, 2017 9:00PM"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "models": {
                          "type": "object",
                          "properties": {
                            "total": {
                              "type": "integer",
                              "example": 0,
                              "default": 0
                            },
                            "rows": {
                              "type": "array"
                            }
                          }
                        },
                        "created_at": {},
                        "updated_at": {}
                      }
                    },
                    {
                      "title": "Not Found",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "error"
                        },
                        "messages": {
                          "type": "string",
                          "example": "Fieldset not found"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"error\",\n  \"message\": \"Unauthorized.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "error"
                    },
                    "message": {
                      "type": "string",
                      "example": "Unauthorized."
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "405",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"error\",\n  \"messages\": \"Method not allowed\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "error"
                    },
                    "messages": {
                      "type": "string",
                      "example": "Method not allowed"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Authorization",
        "value": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIyIiwianRpIjoiN2I1OTg3ZGVlYzI0ZmUxNzZmM2M4Y2VmZmFkOWZhZTMwOGY5YTc5MWU5OTI1MjljMWRmMDFmMTFjYThjMWRmZWE5YTlhODdhMDcxOTA2Y2IiLCJpYXQiOjE3ODY2NjIwMzYuMzExNjY1LCJuYmYiOjE3ODY2NjIwMzYuMzExNjcsImV4cCI6MjQxNzgxNDAzNi4yOTc4MDcsInN1YiI6IjEiLCJzY29wZXMiOltdfQ.bsToXzAmDU_c0WfA36bjgIfP9reBXaDrV3vEz78fJ6mdvnGBBPfqRFD3nb2NL6Zr2X3EavWoFA2-Adn3L-0Ds7OFBfU9jdyu5vlaA-f6BHVBuJlGu2NO0SuYmlRG-2DqMQL8MHjM2NQ4k1HX5UV8ox9fzxXAe9nD7wmV0mgWtWAyq29XfiBZQcYWLKjam0LnvHbFnL29ikVazCK6_Kl9_7d0gkX32QdgbtgIFDmrngSHnAeO2wTvUvf-rz8HsV0cv_9SALuLPNSUXiKjC2amSsgzU05a0xFmMYu3mSmfgH2PDC2qAsByjOlU5yQDv2hTEBEle0c2N2-z1mL-udi49a1FreedSX0Vxm04RTFTO4UwZUO4TGsLu47JheVPuMUN5V4FUCpXPX6qoyiBrGHPWx6cfjYzEK0joJeNi9Q5LwMjZxmJ_1K2P13lTcw67fJEHQeBoiYles4TJXzgmKpYJtGRMdcdiLj8zFiDZYnq31imndZTjfIT5oTY5owEfKRCcfxoDjFMi7mrr0zpi1Tx9bGDUQLD50aoa3M1zqSQvOqi6StvWE-vDGYbRE3oNRIOtL5xQslLMLsvEK4etz_CsYW0WJ-tu_rKs7muU5yM0gIW2pCFiMbNGzJp37uFrxTD5LGn3b-r0gNhMWLYKGzYRIeyRWir2vymf2I0RX5wL5s"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```