# Namirial Notify APIs

Unified OpenAPI reference for the Namirial Notify service APIs. This specification aggregates EviNotice, EviMail, EviSMS, EviPost, and shared attachment download endpoints. In the public Namirial Notify API environments, EviMail, EviSMS, and EviPost are exposed under the `/v1` base path. Some lower-level technical artifacts may show those V1 routes without the prefix. For customer integrations, use the public paths shown in this specification. For the public Namirial Notify API environments, EviNotice routes use the `/v2` base path. The legacy `/api/v2/...` form is still accepted for backward compatibility.


Version: 1.0

## Servers

Production
```
https://api.evicertia.com
```

Pre-production / QA
```
https://api.ecertia.com
```

## Security

### basicAuth

Type: http
Scheme: basic

## Download OpenAPI description

[Namirial Notify APIs](https://docs.namirial.app/_bundle/products/namirialnotify/apis/oas/namirialnotify-api.yaml)

## EviNotice

Certified hosted notices with hosted content, attachments, and affidavit downloads.

### Submit a new EviNotice

 - [POST /v2/EviNotice/Submit](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticesubmit.md)

### Get a single EviNotice

 - [GET /v2/EviNotice/{Id}](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticeget.md)

### Query multiple EviNotices

 - [POST /v2/EviNotice/Query](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticequery.md)

### Download all attachments of an EviNotice

 - [GET /v2/EviNotice/{Id}/Attachments](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticeattachmentsdownload.md)

### Download all affidavits of an EviNotice

 - [GET /v2/EviNotice/{Id}/Affidavits](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticeaffidavitsdownload.md)

### Download one EviNotice affidavit

 - [GET /v2/EviNotice/Affidavits/{Id}](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticeaffidavitdownload.md)

### Request an on-demand affidavit

 - [POST /v2/EviNotice/Affidavits/Request](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evinotice/evinoticeaffidavitrequest.md): Generates a custom affidavit for a previously submitted EviNotice. The original submit request must have included AffidavitKinds with the OnDemand value. The notice must still be eligible — not Draft, not Closed, and within the configured per-notice on-demand limit.

## EviMail

Certified email delivery, status tracking, and on-demand affidavits.

### Submit a certified email

 - [POST /v1/EviMail/Submit](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evimail/evimailsubmit.md)

### Query certified emails (GET)

 - [GET /v1/EviMail/Query](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evimail/evimailqueryget.md)

### Request an on-demand affidavit

 - [POST /v1/EviMail/AffidavitRequest](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evimail/evimailaffidavitrequest.md): Generates a custom affidavit for a previously submitted EviMail. The original Submit request must have included AffidavitKinds containing OnDemand, and the communication must still be eligible for on-demand affidavits.

## EviSMS

Certified SMS and RCS delivery with status tracking and evidence retrieval.

### Submit a certified SMS

 - [POST /v1/EviSms/Submit](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evisms/evismssubmit.md)

### Query certified SMS messages (GET)

 - [GET /v1/EviSms/Query](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evisms/evismsqueryget.md)

## EviPost

Certified physical postal delivery with status tracking and on-demand affidavits.

### Submit a certified postal communication

 - [POST /v1/EviPost/Submit](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evipost/evipostsubmit.md)

### Query certified postal communications (GET)

 - [GET /v1/EviPost/Query](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evipost/evipostqueryget.md)

### Request an on-demand affidavit

 - [POST /v1/EviPost/AffidavitRequest](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evipost/evipostaffidavitrequest.md): Generates a custom affidavit for a previously submitted EviPost. Requires that AffidavitsOnDemandEnabled: true was set in the original Submit request, and that AffidavitProfile was set to AdvancedContentOnSubmit, AdvancedContentOnClose, or AdvancedContentOnSubmitAndOnClose. The affidavit is generated asynchronously.

### Cancel a postal communication

 - [POST /v1/EviPost/Cancel](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/evipost/evipostcancel.md): Cancels a previously submitted EviPost that has not yet been dispatched to the postal carrier. Only the account that submitted the postal communication can cancel it. Requires the CanUseCancel permission in addition to the standard EviPost API permission.

## Shared Downloads

Shared attachment download endpoints.

### Download attachments by ID

 - [POST /AttachmentDownload](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/shared-downloads/attachmentdownloadpost.md)

### Download attachments by ID using query parameters

 - [GET /AttachmentDownload](https://docs.namirial.app/products/namirialnotify/apis/oas/namirialnotify-api/shared-downloads/attachmentdownloadget.md)