# Get a notice batch

Retrieves the full state of a batch, including its configured notice template and processing progress.

Endpoint: GET /v2/EviNotice/Batches/{BatchId}
Version: 1.0
Security: basicAuth

## Path parameters:

  - `BatchId` (string, required)
    The UUID of the batch, as returned at creation.

## Response 200 fields (application/json):

  - `Id` (string)

  - `State` (string)
    Enum: "Draft", "Submitted", "Scheduled", "Processing", "Processed", "Invalid", "Failed"

  - `Submitter` (string)
    Display name of the user who created the batch.

  - `SubmitterId` (string)

  - `SiteName` (string)

  - `SiteId` (string)

  - `Description` (string)

  - `CreationDate` (string)

  - `ScheduledFor` (string)
    Scheduled execution date and time in UTC.

  - `StartedOn` (string)

  - `ProcessedOn` (string)

  - `SubmittedOn` (string)

  - `InvalidOn` (string)

  - `LastUpdated` (string)

  - `TotalCount` (integer)
    Total number of recipients in the batch.

  - `EviNotice` (object)
    The notice template configured for the batch (the per-notice settings applied to every recipient).

  - `EviNotice.Subject` (string)

  - `EviNotice.Body` (string)
    HTML body of the notice.

  - `EviNotice.IssuerName` (string)

  - `EviNotice.From` (string)

  - `EviNotice.DisableSenderHeader` (boolean)

  - `EviNotice.ReplyTo` (string)

  - `EviNotice.CostCentre` (string)

  - `EviNotice.TimeToLive` (integer)

  - `EviNotice.CertificationLevel` (string)
    Enum: "None", "Standard", "Advanced", "QERDS", "Standard_CO", "Standard_CR", "Standard_EC", "Standard_EU", "Standard_MX", "Standard_PE", "Advanced_CO", "Advanced_CR", "Advanced_EC", "Advanced_EU", "Advanced_MX", "Advanced_PE", "QERDS_ES", "QERDS_IT"

  - `EviNotice.LtaStorage` (boolean)
    Enables post-close LTA storage for every notice generated from the batch. Each notice is stored after its own tracking reaches Closed. Requires LTA to be enabled for the site.

  - `EviNotice.AffidavitKinds` (array)
    Enum: "Submitted", "SubmittedAdvanced", "Dispatched", "TransmissionResult", "DeliveryResult", "Received", "Read", "Committed", "CommittedAdvanced", "Refused", "Closed", "ClosedAdvanced", "Event", "Complete", "CompleteAdvanced", "OnDemand", "ContentDownload", "Failed"

  - `EviNotice.Language` (string)

  - `EviNotice.AffidavitLanguage` (string)

  - `EviNotice.OnlineRetentionPeriod` (integer)

  - `EviNotice.PushNotificationUrl` (string)

  - `EviNotice.PushNotificationFilter` (array)
    Enum: "Processed", "Sent", "Dispatched", "Delivered", "Received", "Read", "Replied", "Failed", "Closed", "AffidavitPublished"

  - `EviNotice.PushNotificationExtraData` (string)

  - `EviNotice.CommitmentOptions` (string)
    Enum: "Disabled", "Accept", "Reject", "AcceptOrReject"

  - `EviNotice.CommitmentCommentsAllowed` (boolean)

  - `EviNotice.RejectReasons` (array)

  - `EviNotice.AcceptReasons` (array)

  - `EviNotice.RequireRejectReason` (boolean)

  - `EviNotice.RequireAcceptReason` (boolean)

  - `EviNotice.DeliveryAppearance` (string)
    Enum: "Certified", "AsIs"

  - `EviNotice.AllowRefusal` (boolean)

  - `EviNotice.OwnerNotificationTemplate` (string)

  - `EviNotice.Channel` (string)

  - `BatchPushNotificationUrl` (string)

  - `SentCount` (integer)
    Number of notices dispatched so far.

  - `FailedCount` (integer)
    Number of notices that failed.

  - `ProgressPercentage` (number)
    Processing progress as a percentage (0–100).

  - `ExtraFields` (array)
    Names of the custom recipient columns detected in the uploaded CSV.

  - `InvalidReason` (string)
    Explanation when the batch is in the Invalid state.

  - `CsvId` (string)

  - `Outcome` (string)


## Response 400 fields

## Response 401 fields

## Response 404 fields