# List bulk-envelope file tasks

Returns the tasks of a specific bulk-envelope file.

Endpoint: GET /api/v1/organizations/{organizationId}/bulk-envelopes/{bulkEnvelopeId}/files/{fileId}/tasks
Version: v1
Security: Bearer, PersonalAccessToken

## Security:

  - `Bearer` (unknown)
    http bearer JWT

  - `PersonalAccessToken` (unknown)
    apiKey in header Personal-Access-Token

## Path parameters:

  - `organizationId` (string, required)
    Unique identifier of the organization

  - `bulkEnvelopeId` (string, required)

  - `fileId` (string, required)
    Unique identifier of the file

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `tasks` (array, required)
    The list of tasks.

  - `tasks.field` (any, required)
    The field definition.

  - `tasks.field.id` (string, required)
    The field ID.

  - `tasks.field.page` (integer)
    The page number where the field is placed.

  - `tasks.field.positionX` (number)
    The horizontal position of the field on the page.

  - `tasks.field.positionY` (number)
    The vertical position of the field on the page.

  - `tasks.field.width` (number)
    The width of the field.

  - `tasks.field.height` (number)
    The height of the field.

  - `tasks.field.allowedSignatureTypes` (array)
    The allowed signature types for this field.

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "ClickToSignSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "DrawToSignSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "TypeToSignSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "LocalCertificateSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "DisposableCertificateSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "BiometricSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "RemoteCertificateSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "OneTimePasswordSignature"

  - `tasks.field.allowedSignatureTypes.pluginId` (string, required)
    The plugin ID.

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "PluginSignature"

  - `tasks.field.allowedSignatureTypes.signatureType` (string, required)
    Enum: "AutomaticSignature"

  - `tasks.field.qualifiedTimeStamp` (boolean)
    Whether the signature must use a qualified timestamp server. Optional. When omitted, the value `false` is applied at the downstream Nova boundary.
    Example: true

  - `tasks.field.required` (boolean)
    Whether the field is required.

  - `tasks.field.batchGroup` (string)
    The optional batch-signing group this field belongs to.
    Example: group1

  - `tasks.field.layoutId` (string)
    The optional identifier of the signature layout applied to this field, one of the organization's signature layouts. When omitted, the organization default layout is used.
    Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

  - `tasks.field.font` (object)
    Font style configuration for a field.

  - `tasks.field.font.size` (integer, required)
    The font size.

  - `tasks.field.font.name` (string, required)
    The font name.

  - `tasks.field.font.color` (string, required)
    The font color.

  - `tasks.field.font.align` (string, required)
    Text alignment options.
    Enum: "Left", "Center", "Right"

  - `tasks.field.font.italic` (boolean, required)
    Whether the font is italic.

  - `tasks.field.font.bold` (boolean, required)
    Whether the font is bold.

  - `tasks.field.textInputConfig` (any, required)
    The text input configuration.

  - `tasks.field.textInputConfig.textInputType` (string, required)
    Enum: "StringType"

  - `tasks.field.textInputConfig.value` (string, required)
    The text value.

  - `tasks.field.textInputConfig.password` (boolean, required)
    Whether the field is a password field.

  - `tasks.field.textInputConfig.multiline` (boolean, required)
    Whether the field allows multiline input.

  - `tasks.field.textInputConfig.maxLength` (integer, required)
    The maximum length of the text.

  - `tasks.field.textInputConfig.textInputType` (string, required)
    Enum: "DateType"

  - `tasks.field.textInputConfig.value` (string)
    The date value.

  - `tasks.field.textInputConfig.format` (string, required)
    Available date display formats for a date text input.
    Enum: "dd.MM.yy", "dd.MM.yyyy"

  - `tasks.field.textInputConfig.minValue` (string)
    The minimum allowed date.

  - `tasks.field.textInputConfig.maxValue` (string)
    The maximum allowed date.

  - `tasks.field.textInputConfig.textInputType` (string, required)
    Enum: "NumberType"

  - `tasks.field.textInputConfig.value` (number)
    The numeric value.

  - `tasks.field.textInputConfig.thousandsSeparator` (string, required)
    The thousands separator used by a number text input.
    Enum: "Comma", "Point", "Apostrophe", "Blank", "None"

  - `tasks.field.textInputConfig.decimalSeparator` (string, required)
    The decimal separator used by a number text input.
    Enum: "Comma", "Point", "Apostrophe", "None"

  - `tasks.field.textInputConfig.symbol` (object)
    The currency or unit symbol of a number input and its position.

  - `tasks.field.textInputConfig.symbol.value` (string)
    The currency or unit symbol value.

  - `tasks.field.textInputConfig.symbol.position` (string, required)
    The position of the symbol relative to a number value.
    Enum: "Start", "StartWithBlank", "End", "EndWithBlank"

  - `tasks.field.textInputConfig.decimalPlaces` (integer, required)
    The number of decimal places.

  - `tasks.field.textInputConfig.minValue` (number)
    The minimum allowed value.

  - `tasks.field.textInputConfig.maxValue` (number)
    The maximum allowed value.

  - `tasks.field.textInputConfig.textInputType` (string, required)
    Enum: "PhoneNumberType"

  - `tasks.field.textInputConfig.value` (string, required)
    The phone number value.

  - `tasks.field.textInputConfig.format` (string, required)
    The phone number display format of a phone number text input.
    Enum: "International", "InternationalLeadingZeros", "InternationalLeadingPlus"

  - `tasks.field.textInputConfig.textInputType` (string, required)
    Enum: "TimeType"

  - `tasks.field.textInputConfig.value` (string)
    The time value.

  - `tasks.field.textInputConfig.format` (string, required)
    Available time display formats for a time text input.
    Enum: "HH:mm"

  - `tasks.field.textInputConfig.minValue` (string)
    The minimum allowed time.

  - `tasks.field.textInputConfig.maxValue` (string)
    The maximum allowed time.

  - `tasks.field.readOnly` (boolean)
    Whether the field is read-only.

  - `tasks.field.checked` (boolean)
    Whether the checkbox is checked.

  - `tasks.field.value` (string)
    The value of the checkbox.

  - `tasks.field.options` (array)
    The list of options.

  - `tasks.field.options.key` (string, required)
    The option key.

  - `tasks.field.options.value` (string, required)
    The option value.

  - `tasks.field.options.selected` (boolean, required)
    Whether the option is selected.

  - `tasks.field.multiselect` (boolean)
    Whether multiple options can be selected.

  - `tasks.field.reference` (string)
    The Reference of the link.

  - `tasks.field.annotationConfig` (any, required)
    The annotation configuration.

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "FullName"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "FirstName"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "LastName"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "Initials"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "Email"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "Date"

  - `tasks.field.annotationConfig.annotationType` (string, required)
    Enum: "Text"

  - `tasks.field.annotationConfig.value` (string)
    The default value for the text annotation.

  - `tasks.field.elementName` (string)
    The name of the element.

  - `tasks.field.groupName` (string)
    The group name for the radio button.

  - `tasks.field.checked` (boolean)
    Whether the radio button is checked.

  - `tasks.field.readOnly` (boolean)
    Whether the radio button is read-only.

  - `tasks.field.value` (string)
    The value of the radio button.

  - `tasks.field.qualifiedTimeStamp` (boolean)
    Whether the signature must use a qualified timestamp server.

  - `tasks.recipientId` (string)
    The ID of the recipient assigned to this task.

  - `tasks.stageId` (string)
    The ID of the Bulk Stage assigned to this task, when the task is not assigned to a specific recipient.

  - `tasks.sortOrder` (integer, required)
    The position of the task in the sequence.

  - `tasks.source` (string, required)
    The origin of a field on a file.
    Enum: "File", "UserDefined"

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 422:

  - `422` (unknown)
    Unprocessable Content

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

