---
updatedAt: 2026-04-28T08:04:37.000Z
agentTools:
  projectIndex: https://developers.wrike.com/llms.txt
---

# Query Specific Custom Item Type by ID

Returns custom item type(s) for specified type ID(s).

<b>Scopes:</b> Default, wsReadOnly, wsReadWrite

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Wrike API",
    "version": "4.0"
  },
  "servers": [
    {
      "url": "https://www.wrike.com/api/v4"
    },
    {
      "url": "https://app-eu.wrike.com/api/v4"
    },
    {
      "url": "https://app-us2.wrike.com/api/v4"
    }
  ],
  "paths": {
    "/custom_item_types/{customItemTypeIds}": {
      "get": {
        "tags": [
          "Custom Item Types"
        ],
        "summary": "Query Specific Custom Item Type by ID",
        "description": "Returns custom item type(s) for specified type ID(s).\n\n<b>Scopes:</b> Default, wsReadOnly, wsReadWrite",
        "operationId": "GET:/custom_item_types/multi",
        "parameters": [
          {
            "name": "customItemTypeIds",
            "in": "path",
            "description": "Comma-separated list of ids. Limit : 1000",
            "required": true,
            "content": {
              "text/csv": {
                "schema": {
                  "maxItems": 1000,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EntityTypeId"
                  }
                }
              }
            }
          },
          {
            "name": "withDeleted",
            "in": "query",
            "description": "Include deleted custom item types in the result",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Include deleted custom item types in the result",
              "default": "false"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "description": "Json string array of optional fields to be included in the response model\n* `dataUsageStatistics` - Return collection of data usage statistics",
            "required": false,
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "description": "Json string array of optional fields to be included in the response model",
                  "items": {
                    "type": "string",
                    "enum": [
                      "dataUsageStatistics"
                    ]
                  }
                }
              }
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "success response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "$ref": "#/components/schemas/ResponseKind"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/CustomItemType"
                      }
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "client-side error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "5XX": {
            "description": "server-side error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "HTTP": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ResponseKind": {
        "type": "string",
        "enum": [
          "accounts",
          "users",
          "contacts",
          "assets",
          "eDiscoveryReport",
          "folders",
          "folderTree",
          "tasks",
          "taskIds",
          "timelogs",
          "timelogCategories",
          "timelogLockPeriods",
          "timetrackerTimers",
          "comments",
          "attachments",
          "url",
          "version",
          "dataExport",
          "dataExportSchema",
          "auditLog",
          "accessRoles",
          "stream",
          "changes",
          "posts",
          "mailSettings",
          "integrationInfo",
          "gmailIntegrationSettings",
          "workTypesForIntegrations",
          "ids",
          "backups",
          "domains",
          "dependencies",
          "workflows",
          "workschedules",
          "workscheduleExclusions",
          "workscheduleUserExclusions",
          "customfields",
          "customfieldIds",
          "customstatuses",
          "invitations",
          "notifications",
          "jobroles",
          "placeholders",
          "groups",
          "session",
          "dashboards",
          "widgets",
          "taskCreationSettings",
          "colors",
          "experiments",
          "topics",
          "topicComments",
          "webhooks",
          "reviews",
          "boards",
          "textSearch",
          "chatChannels",
          "chatMessages",
          "forms",
          "requestForms",
          "request",
          "report",
          "platformWidgets",
          "platformWidgetInstances",
          "spaces",
          "pdf",
          "customerSatisfaction",
          "asyncJob",
          "approvals",
          "highlights",
          "highlightsList",
          "highlightsSettings",
          "highlightsCard",
          "timesheet",
          "timesheetRow",
          "timesheetSubmissionRule",
          "mobileFeatures",
          "mobileSettings",
          "folderBlueprintTree",
          "taskBlueprintTree",
          "blueprintSearch",
          "feedback",
          "timeline_snapshot",
          "contactIds",
          "bookings",
          "integrateThreshold",
          "hourlyRatesProvision",
          "hourlyRates",
          "projectTeamMembers",
          "contactsHistory",
          "tasksHistory",
          "foldersHistory",
          "activityDigest",
          "workItemTemplates",
          "workTemplates",
          "workItemMetadata",
          "workItem",
          "customItemTypes",
          "verificationCode",
          "views",
          "listView",
          "tableView",
          "userTypes",
          "reactions",
          "externalRequesters",
          "workscheduleCapacityOverrides",
          "userCapacityOverrides",
          "userCapacityExclusions",
          "rollups",
          "requestFormPrefill",
          "mcpFeatures",
          "attachmentUploadUrl",
          "userAggregatedCapacity",
          "cascadingFieldSettings",
          "recommendResources",
          "aggregatedAllocatedEffort",
          "aggregatedTotalUserEffort",
          "aggregatedTimeSpent",
          "folderBlueprint",
          "taskBlueprint"
        ]
      },
      "CustomFieldId": {
        "pattern": "^([A-Z0-9]){16}$",
        "type": "string"
      },
      "ErrorType": {
        "type": "string",
        "enum": [
          "invalid_request",
          "invalid_parameter",
          "parameter_required",
          "not_authorized",
          "access_forbidden",
          "not_allowed",
          "resource_not_found",
          "method_not_found",
          "too_many_requests",
          "rate_limit_exceeded",
          "server_error"
        ]
      },
      "EntityTypeId": {
        "pattern": "^([A-Z0-9]){16}$",
        "type": "string"
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorType"
          },
          "errorDescription": {
            "type": "string"
          }
        }
      },
      "WorkTypeIcon": {
        "required": [
          "symbol"
        ],
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "Icon symbol"
          },
          "version": {
            "type": "string",
            "description": "Icon version"
          }
        }
      },
      "Datapoint": {
        "required": [
          "timesUsedThisMonth",
          "timesUsedTotal"
        ],
        "type": "object",
        "properties": {
          "lastUsedOn": {
            "type": "string",
            "description": "Last used on<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
          },
          "timesUsedThisMonth": {
            "type": "number",
            "description": "Number of times used this month"
          },
          "timesUsedTotal": {
            "type": "number",
            "description": "Total number of times used"
          },
          "lastUsedBy": {
            "$ref": "#/components/schemas/UserId"
          }
        }
      },
      "DataUsageStatistics": {
        "required": [
          "spaceDataPoints"
        ],
        "type": "object",
        "properties": {
          "spaceDataPoints": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/Datapoint"
            },
            "description": "Map<String, Datapoint> - Space data points"
          },
          "accountDataPoints": {
            "$ref": "#/components/schemas/Datapoint"
          }
        }
      },
      "SpaceId": {
        "pattern": "^([a-zA-Z0-9-_:\\.=]){1,256}$",
        "type": "string"
      },
      "UserId": {
        "pattern": "^([A-Z0-9]){8}$",
        "type": "string"
      },
      "CustomItemType": {
        "type": "object",
        "properties": {
          "spaceId": {
            "$ref": "#/components/schemas/SpaceId"
          },
          "relatedType": {
            "type": "string",
            "enum": [
              "Project",
              "Task"
            ]
          },
          "customFieldIds": {
            "type": "array",
            "description": "Custom fields that are available",
            "items": {
              "$ref": "#/components/schemas/CustomFieldId"
            }
          },
          "isDeleted": {
            "type": "boolean",
            "description": "Custom item type is deleted"
          },
          "archivedOn": {
            "type": "string",
            "description": "Archived date<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
          },
          "icon": {
            "$ref": "#/components/schemas/WorkTypeIcon"
          },
          "description": {
            "type": "string",
            "description": "Custom item type description"
          },
          "id": {
            "$ref": "#/components/schemas/EntityTypeId"
          },
          "title": {
            "type": "string",
            "description": "Work type Title"
          },
          "dataUsageStatistics": {
            "$ref": "#/components/schemas/DataUsageStatistics"
          },
          "archivedBy": {
            "$ref": "#/components/schemas/UserId"
          },
          "addedToSpaces": {
            "type": "array",
            "description": "IDs of spaces the custom item type is added to",
            "items": {
              "$ref": "#/components/schemas/SpaceId"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "HTTP": {
        "type": "http",
        "description": "Use OAuth 2.0 access token or permanent access token for authorization.",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```