Issue Audit Confirmation Letter

The audit confirmation letter ("circularização") is an audit document digitally signed by QI SCD that confirms the balances of the accounts held by the customer at a reference date. It lists every account of the customer's document number within the same requester as the account informed in the path. Once issued, the signed PDF is emailed to the recipients informed in the request (typically the auditor).

Request

ENDPOINT

/account/ACCOUNT_KEY/circularization_letter

METHOD

POST

Path parameters

Field	Type	Description
ACCOUNT_KEY	UUID	Key of any account belonging to the customer. Used only to identify the document number and requester; the letter lists all accounts of the same document number within the requester.

Body parameters

Field	Type	Description	Max. Characters
emails *	array of strings	List of e-mails that will receive the signed PDF. Minimum 1 address. Typically the requesting auditor's e-mail.	-
reference_date *	string (YYYY-MM-DD)	Reference date for the balance calculation. The letter declares each account's closing balance on this date.	10
recipient_name	string	Name of the recipient company/institution, used in the document's salutation ("To the gentlemen of {recipient_name}"). If omitted, defaults to "To whom it may concern,".	-

Request Body

{
  "emails": ["audit@audit-firm.com"],
  "reference_date": "2026-04-30",
  "recipient_name": "BDO RCS Auditores Independentes"
}

Response

STATUS

200

Response Body

{
  "document_key": "f1b8e3a2-c5d4-4e9f-a1b2-3c4d5e6f7a8b",
  "account_key": "3e4b8746-da58-4799-bcd0-063326428d3f",
  "document_type": "circularization_letter",
  "document_status": "pending",
  "external_identifier_key": "certifiqi-batch-group-key",
  "file_url": "https://api.certifiqi.com.br/events/certifiqi-batch-group-key",
  "payload": {
    "emails": ["audit@audit-firm.com"],
    "reference_date": "2026-04-30",
    "recipient_name": "BDO RCS Auditores Independentes"
  },
  "created_at": "2026-05-28T19:50:47",
  "updated_at": "2026-05-28T19:50:47"
}

Response Body parameters

Field	Type	Description	Max. Characters
document_key	UUID	Internal QI identifier of the document.	36
account_key	UUID	Key of the source account.	36
document_type	string	Document type. Always circularization_letter on this route.	-
document_status	string	Current document status. See Enumerators document_status.	-
external_identifier_key	string	External identifier of the signature batch.	300
file_url	string	Current document URL. While pending, points to signature tracking; once sent, points to the signed PDF.	-
payload	object	Echo of the request body.	-
created_at	datetime Zulu	Document creation date.	20
updated_at	datetime Zulu	Last document update.	20

Enumerators document_status

Enumerator	Description
pending	Document created, awaiting signature finalization.
sent	Document signed and e-mails dispatched to recipients.