---
updatedAt: 2026-04-29T08:33:01.000Z
agentTools:
  projectIndex: https://developers.wrike.com/llms.txt
---

# Get Request Form by ID

Get request form by ID.

<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": {
    "/request_forms/{requestFormId}": {
      "get": {
        "tags": [
          "Request forms"
        ],
        "summary": "Get Request Form by ID",
        "description": "Get request form by ID.\n\n<b>Scopes:</b> Default, wsReadOnly, wsReadWrite",
        "operationId": "GET:/request_forms/single",
        "parameters": [
          {
            "name": "requestFormId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FormId"
            }
          },
          {
            "name": "plainTextDescription",
            "in": "query",
            "description": "When true, returns description as plain text (line breaks stripped). When false (default), description is plain text with <br> tags for line breaks.",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "When true, returns description as plain text (line breaks stripped). When false (default), description is plain text with <br> tags for line breaks.",
              "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/RequestForm"
                      }
                    }
                  }
                }
              }
            }
          },
          "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"
        ]
      },
      "RequestForm": {
        "type": "object",
        "properties": {
          "spaceId": {
            "$ref": "#/components/schemas/SpaceId"
          },
          "pages": {
            "type": "array",
            "description": "Pages",
            "items": {
              "$ref": "#/components/schemas/FormPage"
            }
          },
          "description": {
            "type": "string",
            "description": "Description. By default contains plain text with <br> tags for line breaks. Set plainTextDescription=true to receive plain text without HTML tags."
          },
          "id": {
            "$ref": "#/components/schemas/FormId"
          },
          "title": {
            "type": "string",
            "description": "Title"
          },
          "dataUsageStatistics": {
            "$ref": "#/components/schemas/DataUsageStatistics"
          }
        }
      },
      "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"
        ]
      },
      "FormDateFieldLimitType": {
        "type": "string",
        "description": "* `FUTURE_DATE_ONLY`\n* `DATE_BEFORE`\n* `DATE_BETWEEN`\n* `UNLIMITED`\n* `X_DAYS_AFTER_TODAY`\n* `DATE_AFTER`",
        "enum": [
          "FUTURE_DATE_ONLY",
          "DATE_BEFORE",
          "DATE_BETWEEN",
          "UNLIMITED",
          "X_DAYS_AFTER_TODAY",
          "DATE_AFTER"
        ]
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorType"
          },
          "errorDescription": {
            "type": "string"
          }
        }
      },
      "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"
          }
        }
      },
      "FormId": {
        "pattern": "^([A-Z0-9]){16}$",
        "type": "string"
      },
      "FormFieldType": {
        "type": "string",
        "description": "* `Importance`\n* `Email`\n* `User`\n* `Number`\n* `TextArea`\n* `CheckBox`\n* `ComboBox`\n* `TextField`\n* `Attachment`\n* `Date`\n* `Separator`\n* `Name`",
        "enum": [
          "Importance",
          "Email",
          "User",
          "Number",
          "TextArea",
          "CheckBox",
          "ComboBox",
          "TextField",
          "Attachment",
          "Date",
          "Separator",
          "Name"
        ]
      },
      "FormFieldItem": {
        "required": [
          "id",
          "title"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": ""
          },
          "title": {
            "type": "string",
            "description": "Form item title"
          },
          "selectedByDefault": {
            "type": "boolean",
            "description": "True if item is selected by default"
          }
        }
      },
      "FormDateFieldLimit": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "days": {
            "type": "number",
            "description": "Number of days after today"
          },
          "from": {
            "type": "string",
            "description": "Range start date"
          },
          "to": {
            "type": "string",
            "description": "Range end date"
          },
          "type": {
            "$ref": "#/components/schemas/FormDateFieldLimitType"
          }
        }
      },
      "FormPage": {
        "required": [
          "fields",
          "id",
          "title"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": ""
          },
          "title": {
            "type": "string",
            "description": "Page title"
          },
          "fields": {
            "type": "array",
            "description": "Page fields",
            "items": {
              "$ref": "#/components/schemas/FormField"
            }
          }
        }
      },
      "FormField": {
        "required": [
          "id",
          "mandatory",
          "title",
          "type"
        ],
        "type": "object",
        "properties": {
          "dateFormat": {
            "type": "string",
            "description": "Date field format"
          },
          "limit": {
            "$ref": "#/components/schemas/FormDateFieldLimit"
          },
          "id": {
            "type": "string",
            "description": ""
          },
          "title": {
            "type": "string",
            "description": "Form field title"
          },
          "type": {
            "$ref": "#/components/schemas/FormFieldType"
          },
          "mandatory": {
            "type": "boolean",
            "description": "True if field is mandatory"
          },
          "helperText": {
            "type": "string",
            "description": "Helper text for field"
          },
          "items": {
            "type": "array",
            "description": "Field items",
            "items": {
              "$ref": "#/components/schemas/FormFieldItem"
            }
          },
          "prompt": {
            "type": "string",
            "description": "Text field prompt"
          },
          "lineCount": {
            "type": "number",
            "description": "Text area line count"
          }
        }
      },
      "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"
      }
    },
    "securitySchemes": {
      "HTTP": {
        "type": "http",
        "description": "Use OAuth 2.0 access token or permanent access token for authorization.",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```