GET v2/EviNotice/Batches/{batchid}

HTTP Method: GET

Description:

This endpoint retrieves the details of a bulk email batch previously created in the system. The batchid parameter in the URL is the unique identifier returned by the initial batch creation (Submit) endpoint. Additional query parameters allow customization of the level of detail in the response.

Output Parameters

Id (Guid): Unique identifier for the batch.
Submitter (text): User who generates the batch.
SubmitterId (Guid): Identifier of the user who generates the batch.
SiteName (text): Name of the site associated with the batch.
SiteId (Guid): Site identifier associated with the batch.
State (string): The current state of the bulk email/SMS (e.g., Draft, Scheduled, Sent).
CreationDate (datetime): The creation date of the batch in UTC.
LastUpdate (datetime): The last update time of the batch in UTC.
Description (string): Description of the bulk email batch.
SentCount (int): Counter of the shipments made so far.
FailedCount (int): Counter of failed shipments so far.
ProgessPercentage (int): Percentage of progress to date.
Outcome (text): Final result of the shipment process.
TotalCount (int?, optional): The total number of recipients (if IncludeRecipientsCount is true).
Attachments (array, optional): List of attachments (if IncludeAttachments is true), containing:
- DisplayName (string): Descriptive text for the file.
- Data (string): File content in Base64.
- FileName (string): Name of the file.
EviNotice (object): Configuration details for the batch, including:
- Body (string): The message body of the email.
- Subject (string): The subject of the email.
- CostCentre (string)
- CertificationLevel (string)
- LtaStorage (bool)
- AffidavidKind (array)
- Language (string)
- AffidavitLanguage (string)
- OnlineRetentionPeriod (int)
- PushNotificationUrl (string)
- PushNotificationFilter (array)
- PushNotificationExtraData (string)
- CommitmentOptions (string)
- CommitmentCommentsAllowed (bool)
- RejectReasons (array)
- AcceptReasons (array)
- RequireRejectReasons (bool)
- RequireAcceptReasons (bool)
- HideBanners (bool)
- BatchPushNotificationUrl (string)
- AllowRefusal (bool)

Request Example

Basic Request:

Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

GET /v2/EviNotice/Batches/{batchid}

Response Example

Response with All Details:

{
    "Id": "0194db37-0ea6-4fad-b52a-646af6a850f1",
    "State": "Draft",
    "Submitter": "desarrollo.negocio@evicertia.com",
    "SubmitterId": "00005058-3e63-42cf-aa2c-a3160034a66f",
    "SiteName": "certified-communications",
    "SiteId": "426eccb1-a677-4ea7-b9fe-afe800b8f4bc",
    "Description": "Batch invitation mailing",
    "CreationDate": "2025-02-06T12:23:26.1241720+00:00",
    "LastUpdated": "2025-02-06T14:08:29.0000000+00:00",
    "TotalCount": 0,    
    "Attachments": [
        {
            "DisplayName": "User Guide",
            "Data": "JVBERi0xLjQKJcfs...Base64EncodedContent...",
            "FileName": "user_guide.pdf"
        }
    ],
    "EviNotice": {
        "Subject": "This is the subject 006",
        "Body": "This is an Example of Body 09",
        "IssuerName": "Product Team",
        "TimeToLive": 5,
        "CertificationLevel": "Advanced",
        "LtaStorage": false,
        "AffidavitKinds": [
            "Submitted",
            "Read"
        ],
        "Language": "en",
        "AffidavitLanguage": "en",
        "OnlineRetentionPeriod": 1,
        "PushNotificationUrl": "https://eooe1zg89vz4lox.m.pipedream.net",
        "PushNotificationFilter": [
            "Delivered"
        ],
        "CommitmentOptions": "AcceptOrReject",
        "CommitmentCommentsAllowed": true,
        "RejectReasons": [
            "Content not relevant",
            "Incorrect recipient"
        ],
        "AcceptReasons": [
            "Confirmed interest",
            "Interested in details"
        ],
        "RequireRejectReason": false,
        "RequireAcceptReason": false,
        "AllowRefusal": false
    }
    "BatchPushNotificationUrl": "https://eooe1zg89vz4lox.m.pipedream.net",
    "SentCount": 0,
    "FailedCount": 0,
    "ProgressPercentage": 0,
    "Outcome": "None"
}

Notes

Flexible Detail Levels:
- Use query parameters (IncludeOptions, IncludeRecipientsCount, IncludeAttachments) to control the detail level in the response.
- By default, all optional properties (Options, RecipientsCount, Attachments) are excluded.
Batch ID:
- The batchid in the URL must correspond to an existing batch created in the system.
Efficient Retrieval:
- Avoid setting unnecessary query parameters to reduce response size and improve performance.

Certified Communications