# Query multiple EviNotices

Endpoint: POST /v2/EviNotice/Query
Version: 1.0
Security: basicAuth

## Request fields (application/json):

  - `Limit` (integer)
    Maximum number of results to return per page.

  - `Owner` (string)
    Filter by the email address of the account that submitted the notices.

  - `LookupKeys` (array)
    Filter by one or more integrator-assigned lookup keys.

  - `LinkedId` (string)
    Filter by linked ID.

  - `State` (string)
    Filter by current notice state.
    Enum: "Draft", "Submitted", "Processed", "Sent", "Dispatched", "Delivered", "Received", "Read", "Replied", "Closed", "Failed"

  - `Outcome` (string)
    Filter by certification outcome.
    Enum: "None", "Certified", "Sent", "Delivered", "Received", "Read", "Accepted", "Rejected", "Failed", "Cancelled", "Refused"

  - `Cursor` (string)
    Opaque pagination cursor returned in the previous response. Pass this value to retrieve the next page.

## Response 200 fields (application/json):

  - `Cursor` (string)
    Opaque cursor for the next page of results. Pass this value as Cursor in a subsequent request to retrieve the next page. Absent when there are no further results.

  - `Results` (array)
    The list of EviNotice summaries matching the query.

  - `Results.Id` (string)
    Unique identifier of the EviNotice.

  - `Results.LinkedId` (string)
    ID of a related EviNotice, if applicable.

  - `Results.Subject` (string)
    Subject of the certified notice.

  - `Results.LookupKey` (string)
    The integrator-assigned lookup key.

  - `Results.Issuer` (string)
    Legal name of the issuing organisation.

  - `Results.IssuerEmail` (string)
    Email address of the issuer account.

  - `Results.IssuerPhone` (string)
    Phone number of the issuer account, if set.

  - `Results.RecipientAddress` (string)
    Email address where the delivery notification was sent.

  - `Results.RecipientDisplayName` (string)
    Display name of the recipient.

  - `Results.RecipientLegalName` (string)
    Legal name of the recipient.

  - `Results.State` (string)
    Current step in the notice lifecycle.
    Enum: "Draft", "Submitted", "Processed", "Sent", "Dispatched", "Delivered", "Received", "Read", "Replied", "Closed", "Failed"

  - `Results.Outcome` (string)
    Overall result of the certification process. When a notice is refused, the lifecycle completes with state Closed and outcome Refused — Refused does not appear as a lifecycle state. Cancelled may appear on legacy records; its trigger is not part of the standard integration flow.
    Enum: "None", "Certified", "Sent", "Delivered", "Received", "Read", "Accepted", "Rejected", "Failed", "Cancelled", "Refused"

  - `Results.CreationDate` (string)

  - `Results.LastUpdateDate` (string)

  - `Results.SubmittedOn` (string)
    Timestamp when the submission was accepted by the platform.

  - `Results.ProcessedOn` (string)
    Timestamp when the submission was validated and processing started.

  - `Results.SentOn` (string)
    Timestamp when transmission of the notification was confirmed — accepted by the recipient's mail system (email) or by the messaging operator (mobile channels). Always equal to or later than DispatchedOn.

  - `Results.DispatchedOn` (string)
    Timestamp when the platform completed its checks and accepted responsibility for the communication. The notification is not yet sent, so DispatchedOn precedes SentOn and typically matches ProcessedOn.

  - `Results.DeliveredOn` (string)
    Email: timestamp when delivery to the recipient's mail system was confirmed — best-effort, may be absent even when the message was delivered. Mobile channels: operator delivery confirmation.

  - `Results.ReadOn` (string)
    Timestamp when the recipient accessed the protected content on the platform.

  - `Results.RepliedOn` (string)

  - `Results.ExpiredOn` (string)

  - `Results.AcceptedOn` (string)

  - `Results.RejectedOn` (string)

  - `Results.FailedOn` (string)

  - `Results.RefusedOn` (string)

  - `Results.ArchivedOn` (string)

  - `Results.TimeToLive` (integer)
    The TimeToLive value (in minutes) that was set at submission.

  - `Results.AllowRefusal` (boolean)
    Whether the recipient was allowed to refuse the notice without opening it.

  - `Results.NotaryProfile` (string)
    The notary certification profile applied.

  - `Results.SourceChannel` (string)
    The channel through which the notice was submitted (e.g. API, portal).

  - `Results.OnlineRetentionPeriod` (integer)
    Number of years the notice and its evidence remain accessible online.

  - `Results.NotaryRetention` (boolean)
    Whether the evidence is retained by a notary for long-term legal storage.

  - `Results.ReceivedOn` (string)
    Timestamp when the recipient opened the access link and reached the delivery page on the platform.

  - `Results.From` (string)
    From address used in the delivery notification email.

  - `Results.CostCentre` (string)
    Cost-centre label recorded with the transaction for internal billing allocation.

  - `Results.CommitmentComments` (string)
    Free-text comment provided by the recipient when accepting or rejecting the notice.

  - `Results.AffidavitKinds` (array)
    The affidavit event types configured at submission.

  - `Results.Reminders` (object)
    Reminder configuration as set at submission. Absent when no reminders were configured.

  - `Results.Reminders.Initial` (string, required)
    ISO 8601 duration after submission before the first reminder is sent. For example, P2D means the first reminder fires 2 days after submission.
    Example: "P2D"

  - `Results.Reminders.Repeat` (string, required)
    ISO 8601 duration between subsequent reminders after the first one. For example, P1D means reminders repeat every day.
    Example: "P1D"

  - `Results.Reminders.Days` (array, required)
    Days of the week on which reminders may be sent.
    Enum: "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"

  - `Results.Reminders.TimeRange` (array, required)
    Time-of-day windows during which reminders may be sent.
    Enum: "FROM08TO10", "FROM10TO12", "FROM12TO15", "FROM15TO19"

  - `Results.Reminders.Max` (integer)
    Maximum number of reminders to send in total.
    Example: 5

  - `Results.Reminders.Stop` (string, required)
    ISO 8601 duration after submission at which point no further reminders are sent, regardless of Max. For example, P15D stops reminders after 15 days.
    Example: "P15D"

  - `Results.Reminders.TimeZone` (string, required)
    IANA time zone identifier used to interpret the Days and TimeRange windows.
    Example: "Etc/GMT-1"

  - `Results.NotificationChannels` (array)
    Channels used to deliver the notification to the recipient.
    Enum: "SMS", "WhatsApp", "RCS", "Email"

  - `Results.MobilePinChannels` (array)
    PIN delivery channel groups as configured at submission. Each element is an array of channels tried in parallel for that attempt.
    Enum: "SMS", "WhatsApp", "RCS"


## Response 401 fields