# Get a single EviNotice

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

## Security:

  - `basicAuth` (unknown)
    http basic

## Path parameters:

  - `Id` (string, required)
    The UUID of the EviNotice returned at submission.

## Query parameters:

  - `IncludeAffidavits` (boolean)
    Include affidavit metadata in the response.

  - `IncludeAttachments` (boolean)
    Include attachment metadata in the response.

## Response 200:

  - `200` (unknown)
    EviNotice retrieved

## Response 200 fields (application/json):

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

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

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

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

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

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

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

  - `RecipientAddress` (string)
    Email address or mobile number of the recipient.

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

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

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

  - `Outcome` (string)
    None while open. At Closed, the first recorded milestone in this order determines the final outcome: Failed, Rejected, Accepted, Refused, Read, Received, Delivered, Sent, Certified. Received records access to the hosted notice link. Read records opening the hosted content. Cancelled is a compatibility value in the response enum and is not produced by current closure logic.
    Enum: "None", "Certified", "Sent", "Delivered", "Received", "Read", "Accepted", "Rejected", "Failed", "Cancelled", "Refused"

  - `CreationDate` (string)

  - `LastUpdateDate` (string)

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

  - `ProcessedOn` (string)
    Timestamp recorded for the Processed milestone. It is populated after initial processing and content certification succeed, but its value is the admission time recorded at submission, so it normally equals SubmittedOn and does not measure processing duration.

  - `SentOn` (string)
    Event time reported by the successful notification sending result. For email, this is transmission to the recipient's mail system; for mobile channels, successful transmission reported by the sending channel. This does not certify that the hosted notice was read. Do not infer callback arrival order or require strict numerical timestamp ordering from the logical lifecycle sequence.

  - `DispatchedOn` (string)
    Timestamp when the platform, after its initial checks, accepted responsibility for the communication and issued the notification send request to its sending process. It does not confirm successful transmission to the remote system. Dispatch logically precedes the sending result; equal or strictly ordered timestamp values and callback arrival order are not guaranteed.

  - `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.

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

  - `RepliedOn` (string)

  - `ExpiredOn` (string)
    Time the notice closed, whatever the reason (including expiry, decision, refusal or failure); not only TimeToLive expiry.

  - `AcceptedOn` (string)

  - `RejectedOn` (string)

  - `FailedOn` (string)

  - `RefusedOn` (string)

  - `ArchivedOn` (string)

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

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

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

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

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

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

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

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

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

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

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

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

  - `Reminders.Initial` (string, required)
    ISO 8601 duration after submission before the first reminder (for example P2D). Must not exceed TimeToLive. The first reminder ignores Days, TimeRange and Stop; keep Initial before Stop.
    Example: P2D

  - `Reminders.Repeat` (string, required)
    Use a whole-day ISO 8601 interval, for example P1D. Later reminders use the first allowed day/time window on or after the start of the day reached by adding this interval, in TimeZone; this is not an exact elapsed-time interval. Sub-day values are not supported in practice: the next reminder can be scheduled immediately, or in the next allowed window of the same day.
    Example: P1D

  - `Reminders.Days` (array, required)
    Allowed days from the second reminder onward. Do not repeat a day.
    Example: ["Monday","Tuesday","Wednesday","Thursday","Friday"]

  - `Reminders.TimeRange` (array, required)
    Allowed windows from the second reminder onward: FROM08TO10, FROM10TO12, FROM12TO15, FROM15TO19, FROM19TO22 (19:00–22:00). Do not repeat a window.
    Example: ["FROM08TO10","FROM10TO12","FROM12TO15","FROM15TO19"]

  - `Reminders.Max` (integer, required)
    Required, at least 1. For a TTL containing 1 whole day, at most 3; for 2–20 whole days, at most that number of days; above 20 days, at most 20. A TTL shorter than one day has no additional TTL-based cap.
    Example: 5

  - `Reminders.Stop` (string, required)
    ISO 8601 duration from submission; later reminders at or after this point are not scheduled. It does not restrict the first reminder; keep Initial before Stop.
    Example: P15D

  - `Reminders.TimeZone` (string, required)
    One of Etc/GMT-14 through Etc/GMT+11; Etc/GMT0 is UTC. Region names such as Europe/Madrid return 400. The sign is inverted: Etc/GMT-1 means UTC+1.
    Example: Etc/GMT-1

  - `NotificationChannels` (array)
    Channels used to deliver the notification to the recipient.

  - `MobilePinChannels` (array)
    PIN channel groups configured at submission. Each element lists channels offered for one PIN send, not parallel sends. The first PIN, sent when the recipient requests it, uses the first channel of the first group; no channel choice is offered. On a resend, the recipient chooses one channel from the next group (no choice is shown when that group has a single channel); after the third send, the last group is reused.

  - `SiteName` (string)
    Name of the Namirial Notify site under which this notice was submitted.

  - `XmissionResult` (boolean)
    Whether the delivery notification email or SMS was successfully transmitted.

  - `XmissionSummary` (string)
    Human-readable summary of the transmission result (e.g. bounce or SMTP reply code).

  - `CustomLayoutLogoUrl` (string)
    Custom logo URL that was configured at submission.

  - `Affidavits` (array)
    Metadata for each generated affidavit. Present when IncludeAffidavits is true.

  - `Affidavits.Id` (string)
    Unique identifier of the affidavit.

  - `Affidavits.Kind` (string)
    Affidavit response identifier, for example EviNotice:Submitted or EviNotice:Delivery:Result; Legacy when no kind identifier is recorded. See the [identifier mapping](/it/products/namirialnotify/user-guides/evidences-affidavits#evinotice-affidavit-identifiers).

  - `Affidavits.Description` (string)
    Human-readable description of the affidavit.

  - `Affidavits.CreationDate` (string)
    Timestamp when the affidavit was generated.

  - `Affidavits.Length` (integer)
    Size of the affidavit file in bytes.

  - `Attachments` (array)
    Metadata for each attachment. Present when IncludeAttachments is true.

  - `Attachments.Id` (string)
    Unique identifier of the attachment.

  - `Attachments.Filename` (string)
    File name including extension.

  - `Attachments.MimeType` (string)
    MIME type of the attachment.

  - `Attachments.Length` (integer)
    Size of the attachment in bytes.

  - `Attachments.Hash` (string)
    Cryptographic hash of the attachment content, used for integrity verification.

  - `Attachments.IncludeOnAffidavits` (boolean)
    Whether this attachment is referenced in generated affidavits.

## Response 400:

  - `400` (unknown)
    Invalid request

## Response 401:

  - `401` (unknown)
    Authentication failed

## Response 404:

  - `404` (unknown)
    EviNotice not found

