---
updatedAt: 2026-05-27T05:24:21.000Z
agentTools:
  projectIndex: https://developers.toriihq.com/llms.txt
---

# List user custom fields

List user custom fields for connected integrations<br/><br/>
<p><ul><li>Rate limit: 200 requests per minute</li></ul></p>

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://api.toriihq.com/v1.0"
    }
  ],
  "info": {
    "title": "Torii API Documentation",
    "version": "v1.0",
    "description": "The Torii API provides an easy way to integrate your data in Torii with any external system. The API closely follows REST semantics, uses JSON to encode objects, and relies on standard HTTP codes to signal operation outcomes. Torii APIs consist of both proprietary and SCIM 2.0 APIs."
  },
  "x-readme": {
    "explorer-enabled": true
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "User Fields"
    }
  ],
  "openapi": "3.0.0",
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    },
    "schemas": {
      "Model51": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Unique identifier",
            "example": 1000,
            "minimum": 1
          },
          "idOrg": {
            "type": "integer",
            "description": "Unique org identifier",
            "example": 1000,
            "nullable": true,
            "minimum": 1
          },
          "sourceIdApp": {
            "type": "integer",
            "description": "Unique app identifier",
            "example": 1000,
            "minimum": 1,
            "maximum": 2147483647
          },
          "name": {
            "type": "string",
            "example": "Department"
          },
          "type": {
            "type": "string",
            "example": "singleLine"
          },
          "key": {
            "type": "string",
            "example": "departmentName"
          },
          "isDeleted": {
            "type": "boolean",
            "example": false
          }
        }
      },
      "userFields": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Model51"
        }
      },
      "UserFields": {
        "type": "object",
        "description": "User Fields",
        "properties": {
          "fields": {
            "$ref": "#/components/schemas/userFields"
          }
        }
      }
    }
  },
  "paths": {
    "/users/fields": {
      "get": {
        "summary": "List user custom fields",
        "operationId": "getUsersFields",
        "description": "List user custom fields for connected integrations<br/><br/>\n<p><ul><li>Rate limit: 200 requests per minute</li></ul></p>",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "The field name or key to search for"
            },
            "description": "The field name or key to search for"
          }
        ],
        "tags": [
          "User Fields"
        ],
        "responses": {
          "200": {
            "description": "User Fields",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserFields"
                }
              }
            }
          }
        }
      }
    }
  }
}
```