/API reference//
- Submit a certified postal communication
Query certified postal communications (GET)
Request an on-demand affidavit
Cancel a postal communication
Submit a certified postal...
Submit a Base64-encoded PDF smaller than 2,097,152 bytes before encoding. Acceptance does not confirm later PDF validation or postal delivery. A processing failure or postal-service rejection can close the communication with outcome Failed; use Query to check the outcome.
Security
basicAuth
Optional identifier set by the issuer. Can be used later to locate the evidence via the Query endpoint.
Recipient phone number. Use + followed by the country code and phone number, with digits only.
Legal or corporate name of the sender. Supply it explicitly to record it in the evidence.
Issuer phone number. Use + followed by the country code and phone number, with digits only.
- Productionhttps://api.evicertia.com/v1/EviPost/Submit
- Pre-production / QAhttps://api.ecertia.com/v1/EviPost/Submit
curl -i -X POST \
-u '<username>:<password>' \
https://api.evicertia.com/v1/EviPost/Submit \
-H 'Content-Type: application/json' \
-H 'X-Evi-IdempotencyToken: string' \
-d '{
"LookupKey": "a2R4S25kWiu79fsbubSXkw==",
"Document": "<base64-encoded PDF>",
"RecipientName": "Juan Valido",
"RecipientLegalName": "Juan Valido",
"RecipientAddress": {
"StreetAddress": "Gran Via 74, 5 A",
"PostalCode": "28014",
"Locality": "Madrid",
"Region": "Madrid",
"Country": "ES"
},
"RecipientPhone": "+34677000111",
"RecipientEmail": "recipient@example.com",
"IssuerName": "Pedro Comprador",
"IssuerLegalName": "Pedro Valido",
"IssuerAddress": {
"StreetAddress": "C/ Gran Via, 1, 1-A",
"PostalCode": "28001",
"Locality": "Madrid",
"Region": "Madrid",
"Country": "ES"
},
"IssuerPhone": "+34677888777",
"IssuerEmail": "pedro.comprador@example.com",
"IssuerComments": "Sending in March.",
"Options": {
"PostServiceType": "Registered",
"Language": "es",
"CertificationLevel": "Advanced_EU",
"AffidavitProfile": "AdvancedContentOnSubmit",
"AffidavitsOnDemandEnabled": false,
"OnlineRetentionPeriod": 1,
"NotaryRetentionPeriod": 5,
"NotaryProfile": "notary:profile",
"EvidenceAccessControlMethod": "AutoChallenge",
"CostCentre": "dept-legal",
"PushNotificationUrl": "https://your-server.example.com/callbacks/evipost",
"PushNotificationFilter": [
"Processed",
"Sent",
"Delivered",
"Closed"
],
"PushNotificationExtraData": "{\"myId\": \"order-12345\"}"
}
}'Response
{ "uniqueId": "69819c3e0c0e42b3a792a33b014a13a2" }