--- title: "Lists the Fields of a Signature Request Document." method: GET path: "/signature_requests/{signatureRequestId}/documents/{documentId}/fields" tags: ["Field"] --- # Lists the Fields of a Signature Request Document. `GET /signature_requests/{signatureRequestId}/documents/{documentId}/fields` Returns a list of Fields for a given Document. You can limit the number of items returned by using filters. ## Path parameters - `signatureRequestId` string, uuid, required — The unique identifier for a resource. - `documentId` string, uuid, required — The unique identifier for a resource. ## Query parameters - `after` string - `limit` integer - `type` object — Filter by type. - `signer_id` object — Filter by signer_id. - `name` object — Filter by name. ## Response `200` OK - GetSignatureRequestsSignatureRequestIdDocumentsDocumentIdFields200Response - `meta` Pagination — Metadata about the response. - `next_cursor` string, nullable, required — Token to get the next page of results. If `null`, there are no more pages. - `data` GetSignatureRequestsSignatureRequestIdDocumentsDocumentIdFields200ResponseDataInner[] - union - FieldSignature - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'signature', required - `height` integer, required - `width` integer, required - `page` integer, required - `x` integer, required - `y` integer, required - `reason` string, required - `display` union, required — Controls what is shown within the signature field. - object - `layout` 'minimal' | 'legacy', required — • `minimal` (default): Only shows the signer’s signature visual. • `detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature. - object - `layout` 'detailed', required — • `minimal` (default): Only shows the signer’s signature visual. • `detailed`: Adds extra detail to the signature field, including the signer’s full name, email, and the date of signature. - `options` SignatureDisplayOneOf1Options, required — Only applicable when `display.layout = detailed`. - … - FieldText - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'text', required - `width` integer, required — If not set, the width is automatically calculated with the max_length value - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `page` integer, required - `x` integer, required - `y` integer, required - `question` string, required - `instruction` string, nullable, required - `optional` boolean, required - `answer` string, nullable, required - `max_length` integer, required - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - `name` string, nullable - `default_value` string, nullable - `read_only` boolean - FieldMention - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'mention', required - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `width` integer, required - `page` integer, required - `x` integer, required - `y` integer, required - `mention` string, required - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - `name` string, nullable — Name of the Field. - FieldCheckbox - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'checkbox', required - `name` string, nullable, required — Checkbox name - `checked` boolean, required — Signer has checked the checkbox - `page` integer, required - `optional` boolean, required - `x` integer, required - `y` integer, required - `size` integer — The size determines both the width and height of the checkbox. - FieldRadioButtonGroup - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'radio_group', required - `page` integer, required - `optional` boolean, required — Does the Signer has to select one of the radio buttons from this group? - `name` string, nullable, required - `radios` FieldRadioButtonGroupRadiosInner[], required - `name` string, nullable, required — Radio button's name. - `x` integer, required - `y` integer, required - `size` integer, required — The size determines both the width and height of the radio button. - `checked` boolean, required — Signer has checked the radio button. - FieldReadOnlyText - `id` string, uuid, required - `document_id` string, uuid, required - `type` 'read_only_text', required - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `width` integer, required — If not set, the width is automatically calculated with the max_length value - `page` integer, required - `x` integer, required - `y` integer, required - `text` string, required — This property holds the content displayed in the read-only text field. - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - FieldSignatureDate - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'signature_date', required - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `width` integer, required - `page` integer, required - `x` integer, required - `y` integer, required - `value` string, nullable, required - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - `name` string, nullable — Name of the Field. - `date_format` 'dd/MM/yyyy' | 'dd-MM-yyyy' | 'dd.MM.yyyy' | 'yyyy-MM-dd' | 'MM/dd/yyyy' | 'dd MMMM yyyy' | 'MMMM dd, yyyy' | 'MMM dd, yyyy' — Format used to display the date (e.g., `dd/MM/yyyy`, `MM/dd/yyyy`) - `time_format` 'null' | 'HH:mm' | 'hh:mm a', nullable — Format used to display the time. Can be null to display only the date, or a format like `HH:mm` or `hh:mm a` - `show_timezone` boolean, nullable — Boolean indicating whether to display the timezone abbreviation (e.g., `CEST`) next to the time. - `show_email` boolean — Boolean indicating whether to display the signer's email address. - `offset_unit` 'days' | 'weeks' | 'months' | 'years', nullable — Unit of time used to offset the signature date. When `null`, the field will display the exact signature date. - `offset_value` integer, nullable — Number of units to add to the signature date. Ignored if `offset_unit` is `null`. For example, use `offset_unit`: `"month"` and `offset_value: 3` to display "signature date + 3 months" - FieldSignerName - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'signer_name', required - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `width` integer, required - `page` integer, required - `x` integer, required - `y` integer, required - `value` string, nullable, required - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - `name` string, nullable — Name of the Field. - `name_format` 'full_name' | 'first_name' | 'last_name' — Format used to display the signer's name. - FieldSignerEmail - `id` string, uuid, required - `document_id` string, uuid, required - `signer_id` string, uuid, required - `type` 'signer_email', required - `height` integer, required — The height must be calculated using the formula: "height = number_of_lines \* font_size \* line_height", where the line height is always set to 1.5. - `width` integer, required - `page` integer, required - `x` integer, required - `y` integer, required - `value` string, nullable, required - `font` Font, required - `family` 'Inconsolata' | 'Open Sans' | 'Lato' | 'Raleway' | 'Merriweather' | 'EB Garamond' | 'Comic Neue' | 'Monaco' | 'Helvetica' | 'Courier' | 'Times Roman', required - `color` string, required - `size` integer, required - `variants` FontVariants, required - `italic` boolean, required - `bold` boolean, required - `name` string, nullable — Name of the Field. ## Other responses - `400` — Bad request - `401` — Access unauthorized - `403` — Access forbidden - `404` — Resource not found - `405` — This method is not allowed - `429` — Too Many Requests, please try again later. - `500` — Internal Server Error --- [API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/versions/8d258c0b45d6/schema)