API de courrier international pour développeurs et start-up

• Lettres vers l'Europe : notifications, contrats, factures et courriers relatifs aux comptes, destinés à vos clients, utilisateurs ou partenaires en Allemagne, en France, au Royaume-Uni et dans le reste de l'Europe. Elles sont postées à l'intérieur de l'Europe et arrivent habituellement 2 à 4 jours ouvrables après dépôt en Allemagne, en Belgique, en France et aux Pays-Bas, 3 à 6 dans le reste de l'Europe.
• Lettres vers d'autres pays : destinataires dans le monde entier, habituellement 5 à 15 jours ouvrables après dépôt.
• Volumes faibles ou irréguliers : ni abonnement, ni frais mensuels, ni frais d'inscription ; vous payez à la lettre avec votre crédit prépayé.
• Applications avec agents IA : le même compte fonctionne avec notre serveur MCP.

Pour des volumes à l'intérieur des États-Unis, un prestataire américain est généralement plus adapté : nos lettres vers des adresses américaines partent elles aussi d'Europe et mettent habituellement 5 à 15 jours ouvrables. Ces délais sont habituels et non garantis.

L'URL de base est https://printandmailcompany.com/api/v1, la spécification OpenAPI se trouve sur /openapi.json, et les requêtes sont authentifiées par une clé API que vous créez dans votre compte, sous API et assistants IA.

1. Importez le PDF : POST /documents enregistre un PDF A4 ou US Letter et renvoie le résultat du contrôle d'impression. POST /documents/{id}/fix réduit ou rogne les pages qui ne respectent pas la règle des marges de 9 mm. Vous pouvez aussi utiliser POST /compose, qui transforme un texte en lettre A4 mise en page et crée le brouillon.
2. Créez un brouillon : POST /letters avec le document, l'adresse du destinataire et les options d'impression (couleur, recto verso, enveloppe, recommandé). La réponse indique le prix exact TVA comprise ; rien n'est débité.
3. Envoyez la lettre : POST /letters/{id}/send paie la lettre avec votre crédit prépayé et la libère pour l'impression. Si le crédit est insuffisant, l'API répond 402 en indiquant le montant manquant ; pour un PDF US Letter à destination d'un pays qui utilise le format A4, elle demande paperSize (a4 ou us_letter, au même prix).
4. Suivez-la : GET /letters/{id} renvoie le statut (payée, en production, imprimée, postée, annulée ou retournée) et, pour les lettres recommandées, le numéro de suivi. GET /letters?status=posted liste les lettres par statut, et POST /letters/{id}/cancel annule une lettre jusqu'au début de la production, le montant total étant recrédité sur votre solde.

Avant le paiement de la première lettre d'un compte, le nom complet et l'adresse postale de l'expéditeur doivent être renseignés ; votre application peut les transmettre une seule fois, dans sender.

• Devis sans clé : GET /api/v1/quote calcule le prix de n'importe quelle lettre selon le nombre de pages, les options d'impression et la destination, par exemple /api/v1/quote?pages=2&country=DE&registered=true, et GET /api/v1/destinations liste les pays.
• Le prix exact sur chaque brouillon, TVA comprise. Une lettre d'une page en noir et blanc vers l'Allemagne ou la France coûte 4,51 $US ; le recommandé ajoute 12,31 $US (hors TVA).
• Crédit prépayé : rechargez votre crédit par carte dans votre compte (minimum 10,00 CHF / 10,00 € / 10,00 £GB / 10,00 $US) ; GET /balance indique le solde restant. Les cartes émises hors de l'EEE, y compris les cartes américaines, sont soumises à un supplément, affiché avant le paiement.
• Devise du compte : USD, EUR, GBP ou CHF, choisie à l'inscription. Les prix sont fixés en EUR et convertis au taux de référence de la BCE majoré d'une marge de change de 12 %.
• Ni abonnement, ni frais mensuels, ni frais d'inscription, et une facture pour chaque lettre et chaque paiement dans votre compte.

Le tarif complet figure sur la page des tarifs.

Notre serveur MCP, à l'adresse https://printandmailcompany.com/mcp, offre les mêmes fonctions aux agents IA : Claude, ChatGPT, Cursor ou votre propre agent peuvent établir des devis, vérifier des PDF, rédiger une lettre avec compose_letter, créer un brouillon avec create_letter et l'envoyer avec send_letter.

• Connexion : OAuth 2.1 avec PKCE, ou une clé API.
• Validation : send_letter exige la confirmation explicite de l'utilisateur, et le paiement provient uniquement du crédit prépayé ; si le crédit est insuffisant, l'agent reçoit un lien de recharge destiné à l'utilisateur.
• Statut : get_letter et list_letters indiquent le statut et les numéros de suivi.

Les instructions de configuration sont sur la page Assistants IA ; voir aussi envoyer des lettres avec l'IA.

• Documents : PDF au format A4 ou US Letter, de 250 pages et 4 Mo maximum, avec 9 mm libres sur chaque bord. Nous imprimons au format de votre PDF ; vers les États-Unis, le Canada et les territoires américains, les PDF US Letter sont imprimés sur papier US Letter.
• Options d'impression : noir et blanc ou couleur, recto ou recto verso ; enveloppes DL, C5 ou C4, la plus petite enveloppe adaptée étant choisie automatiquement.
• Adresse : imprimée directement sur l'enveloppe, au format postal du pays de destination : vos modèles n'ont pas besoin d'être adaptés à une enveloppe à fenêtre. L'adresse de notre société sert d'adresse de retour, et une lettre qui nous revient affiche le statut « Retournée ».
• Recommandé : recommandé international avec numéro de suivi et signature à la remise, et non le service américain US Certified Mail.
• Production : les lettres payées avant 12 h (heure d'Europe centrale) un jour ouvrable sont généralement imprimées et postées le même jour ouvrable.
• Données : hébergées dans l'UE ; les fichiers importés sont supprimés 30 jours après l'envoi ; un accord de traitement des données est disponible sur demande.

Nous imprimons uniquement le contenu du PDF : il n'y a donc ni encarts, ni chèques, ni marchandises, et chaque lettre a son propre PDF et son propre destinataire.