--- title: "QuestionDataRows" url: "https://developers.zinnia.com/apis/market-connect-order-entry/versions/50f981c3-db50-4358-884f-31eb427255ec/schemas/QuestionDataRows" --- > Full API specification: https://developers.zinnia.com/apis/market-connect-order-entry/versions/50f981c3-db50-4358-884f-31eb427255ec.md # QuestionDataRows All answer rows for one question or composite collection field id. Use `index` on each row for repeatable collection instances. Each row must include `id`, `type`, and `value` (see QuestionData schema). ## OpenAPI definition ```yaml openapi: 3.0.1 info: title: Market Connect Order Entry API version: 1.0.3 servers: - url: https://dev.api.zinnia.io - url: https://qa.api.zinnia.io - url: https://uat.api.zinnia.io components: schemas: QuestionData: required: - id - type - value type: object properties: id: minLength: 1 type: string description: Must match the field key under `data` for this row (case-insensitive); inside collection rows, must match the leaf key in the item's `data` map. type: minLength: 1 enum: - input - dropdown - radio - checkbox - checkboxgroup - date - phone - email - money - number - label - information - collection - Person - Address - Hidden type: string description: "Data-storage type for the question row. Must match the corresponding blueprint field type and be one of: input, dropdown, radio, checkbox, checkboxgroup, date, phone, email, money, number, label, information, collection, Person, Address, Hidden. Values are case-sensitive." example: input questionText: type: string description: The title of the question shown to the user. This value should be kept in sync with the title property of the associated field nullable: true questionSubText: type: string description: The subtext shown to the user below the question title. This value should be kept in sync with the text property of the associated field nullable: true displayValue: type: string description: The display text representing the user's selected answer. For example, a country dropdown may display 'United States of America' to the user, while the blueprint stores the value as 'USA' nullable: true value: anyOf: - type: string description: String value for simple fields example: PrimaryBeneficiary - type: integer description: Integer value for numeric fields example: 123 - type: number description: Float value for decimal fields format: float example: 123.45 - type: string description: Date value for date fields (YYYY-MM-DD format) format: date example: 2024-01-15 - type: string description: DateTime value for date-time fields (ISO 8601 format) format: date-time example: 2024-01-15T10:30:00Z - type: boolean description: Boolean value for true/false fields example: true - type: array items: type: string example: Income_Replacement description: Array of selected option codes for checkboxgroup fields - type: array items: required: - surrogateId - type - data type: object properties: surrogateId: type: string description: "The surrogate identifier for each set of answers in a collection. Example: a repeatable beneficiary collection with two beneficiaries will have two surrogate IDs." example: 504490-1 type: enum: - collectionItem type: string description: Must be `collectionItem` for each element of a collection value array. example: collectionItem data: type: object additionalProperties: required: - id - type - value type: object properties: id: type: string description: Must match the leaf property name under this collection item's `data` object (case-insensitive). example: 504490_FirstName type: enum: - input - dropdown - radio - checkbox - checkboxgroup - date - phone - email - money - number - label - information - collection - Person - Address - Hidden type: string description: "Data-storage type for the question row. Must match the corresponding blueprint field type and be one of: input, dropdown, radio, checkbox, checkboxgroup, date, phone, email, money, number, label, information, collection, Person, Address, Hidden. Values are case-sensitive." example: input questionText: type: string description: The title of the question shown to the user. This value should be kept in sync with the title property of the associated field example: First Name questionSubText: type: string description: The subtext shown to the user below the question title. This value should be kept in sync with the text property of the associated field example: "" displayValue: type: string description: The display text representing the user's selected answer. For example, a country dropdown may display 'United States of America' to the user, while the blueprint stores the value as 'USA' example: "" value: anyOf: - type: string description: String value for simple fields example: "" - type: integer description: Integer value for numeric fields example: 123 - type: number description: Float value for decimal fields example: 123.45 - type: string description: Date value for date fields (YYYY-MM-DD format) format: date example: 2024-01-15 - type: string description: DateTime value for date-time fields (ISO 8601 format) format: date-time example: 2024-01-15T10:30:00.000Z - type: boolean description: Boolean value for true/false fields example: true description: The actual value of the question (required on each nested question row; JSON null allowed when applicable). description: Dictionary containing question data for this collection item description: Array of CollectionItem for collection type fields description: The actual value of the question (required on each QuestionData row in `data`; JSON null is allowed for an empty optional answer). Can be a string, integer, number, float, date, date-time, boolean, or array of CollectionItem objects depending on the field type. index: type: integer description: Zero-based row index for repeatable collection rows in transaction data lists; 0 for single-value fields. format: int32 prefilled: type: boolean description: True when value is a prefill; omitted in JSON when false. additionalProperties: false description: One row of captured or echoed answer data. Must include id, type, and value (the JSON property `value` must be present on each row; use JSON null for an empty optional answer when applicable). On PUT, `id` must match the enclosing `data` field key (or the leaf key inside a collection item's `data`). `type` must be a QuestionData storage type (see QuestionDataStorageTypes); collection value rows use `collectionItem` on each CollectionItem. QuestionDataRows: title: QuestionDataRows type: array items: $ref: "#/components/schemas/QuestionData" description: All answer rows for one question or composite collection field id. Use `index` on each row for repeatable collection instances. Each row must include `id`, `type`, and `value` (see QuestionData schema). ```