> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.
# Retrieve sent email HTML
> Looks up a sent email by its idempotency key and returns the rendered HTML content. This is used to archive service-of-notice emails as PDF evidence. Requires `emails.email.sender` permission.
## OpenAPI
````yaml api-reference/emails.yaml post /email/retrieve
openapi: 3.0.3
info:
title: emails
description: >-
The Emails Service is responsible for sending emails on behalf of other
services. It also manages and stores all email templates to ensure
consistent and centralized communication formatting.
version: 1.0.0
servers:
- url: https://emails.platform.arb.inc
security: []
tags:
- name: /
- name: email
- name: html
- name: template
- name: webhooks
paths:
/email/retrieve:
post:
tags:
- email
summary: Retrieve sent email HTML
description: >-
Looks up a sent email by its idempotency key and returns the rendered
HTML content. This is used to archive service-of-notice emails as PDF
evidence. Requires `emails.email.sender` permission.
operationId: retrieveEmail
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- idempotencyKey
properties:
idempotencyKey:
type: string
minLength: 1
maxLength: 200
description: Unique key used when the email was originally sent
example: user-123:notice-2025-08-00292
responses:
'200':
description: Successfully retrieved email HTML and subject
content:
application/json:
schema:
type: object
properties:
html:
type: string
description: Rendered HTML content of the email
example: >-
Notice of Service
This is to notify
you...
subject:
type: string
description: Email subject line
example: Notice of Service - Case 2025-08-00292
'404':
description: No email found for the given idempotency key
content:
text/plain:
schema:
type: string
example: no email found for the given idempotency key
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
type: http
description: access token
scheme: bearer
bearerFormat: JWT
````