> ## Documentation Index > Fetch the complete documentation index at: https://docs.younegotiate.com/llms.txt > Use this file to discover all available pages before exploring further. # Download & Print CFPB letters > Generate CFPB validation letter PDFs for active consumers. Batches with 100 or fewer active consumers stream one PDF immediately; larger batches queue a ZIP build and email the owner a download link. ## OpenAPI ````yaml /api/creditor.openapi.yaml post /communications/cfpb-validation-letter/{fileUploadHistory}/download-letters openapi: 3.1.0 info: title: YouNegotiate Creditor API version: '2.0' description: >- Stateless API endpoints for creditor portal authentication and account access. servers: - url: https://api.creditor.younegotiate.com description: Production security: [] tags: - name: System description: Public creditor domain system and health endpoints. - name: Authentication description: Creditor registration, login, password, and email verification endpoints. - name: Account Settings description: >- Authenticated creditor profile, contact, operating-hours, and profile-image endpoints. - name: Account Profile description: >- Creditor onboarding profile, membership, billing, and setup status endpoints. - name: Setup Wizard description: >- Creditor setup wizard status, required-step completion, and optional-step completion. - name: Dashboard description: Creditor dashboard work queues and performance widgets. - name: Import / Export description: >- Creditor consumer import upload sessions, queued imports, history, downloads, and failed-row files. - name: Membership Settings description: >- Creditor membership dashboard, plan changes, payment method, cancellation, special-plan inquiry, and over-limit retry endpoints. - name: Merchant Account description: >- Existing merchant processor credentials, Tilled onboarding, and merchant application endpoints. - name: Header Profiles description: >- CSV header profile upload, mapping, download, and setup wizard completion endpoints. - name: SFTP Connections description: >- Creditor-managed SFTP connection profiles for imports, exports, and setup wizard completion. - name: Sub Accounts description: >- Creditor-managed sub account list, export, create, update, and delete endpoints. - name: Pay Terms Offers description: >- Creditor-managed master, sub-account, group, and group-sub-account Pay Terms endpoints. - name: Individual Custom Offers description: Creditor individual custom offer list endpoints. - name: Negotiations description: >- Creditor negotiation work queues, including notice responses and offer review counts. - name: Communications / CFPB Validation Letter description: >- CFPB Validation Letter tables, secure EcoLetter send/resend, CSV export, and print/download actions. - name: Communications / EcoLetter Template description: >- Creditor EcoLetter template management for secure eLetter communications and campaigns. - name: Communications / Groups description: >- Creditor communication group management for dynamic consumer targeting and campaign selection. - name: Communications / Schedule Campaign description: >- Creditor EcoLetter campaign scheduling, quote, immediate send, and delivery queue endpoints. - name: Communications / Campaign Tracker description: >- Creditor campaign tracker reporting, refresh, and consumer export endpoints. - name: Consumer Profiles description: Creditor Consumer Profiles list, filter options, and CSV export endpoints. - name: Terms & Conditions description: Creditor-managed master and sub-account Terms & Conditions templates. - name: About Us & Contact description: Creditor-managed company About Us content shown to consumers. - name: Logo & Links description: >- Creditor-managed master and sub-account personalized logo colors, size, and consumer link metadata. - name: Users description: >- Master creditor user management, invitations, and account deletion endpoints. paths: /communications/cfpb-validation-letter/{fileUploadHistory}/download-letters: post: tags: - Communications / CFPB Validation Letter summary: Download & Print CFPB letters description: >- Generate CFPB validation letter PDFs for active consumers. Batches with 100 or fewer active consumers stream one PDF immediately; larger batches queue a ZIP build and email the owner a download link. operationId: creditorDownloadCfpbValidationLetters parameters: - $ref: '#/components/parameters/CfpbFileUploadHistoryId' requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/CfpbValidationLetterActionRequest' example: with_qr_code: true responses: '200': description: PDF streamed immediately or large ZIP generation queued. content: application/pdf: schema: type: string format: binary application/json: schema: $ref: '#/components/schemas/CfpbValidationLetterMutationResponse' example: message: >- It takes a bit of time when downloading 100 or more letters. We will email you the link as soon as it's ready! data: id: 42 filename: cfpb-add-accounts.csv active_consumers_count: 101 cfpb: last_action_type: download last_action_label: Download last_action_with_qr: true last_action_cost: '0.00' '401': $ref: '#/components/responses/Unauthenticated' '403': $ref: '#/components/responses/ActiveMembershipRequired' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/ValidationError' security: - bearerAuth: [] components: parameters: CfpbFileUploadHistoryId: name: fileUploadHistory in: path required: true description: CFPB import file upload history ID. schema: type: integer schemas: CfpbValidationLetterActionRequest: type: object additionalProperties: false properties: with_qr_code: type: boolean default: true description: >- Whether the generated CFPB validation letter should include the personalized QR code. CfpbValidationLetterMutationResponse: type: object required: - message - data properties: message: type: string data: $ref: '#/components/schemas/CfpbValidationLetterRow' CfpbValidationLetterRow: type: object additionalProperties: false required: - id - filename - upload_type - active_consumers_count - cfpb - actions - action_items - created_at properties: id: type: integer filename: type: string upload_type: type: object additionalProperties: false required: - value - label properties: value: type: string enum: - manual - sftp label: type: string enum: - Manual - SFTP active_consumers_count: type: integer cfpb: $ref: '#/components/schemas/CfpbValidationLetterSnapshot' uploaded_by: anyOf: - $ref: '#/components/schemas/CfpbValidationLetterUploadedBy' - type: 'null' actions: $ref: '#/components/schemas/CfpbValidationLetterActions' action_items: type: array items: $ref: '#/components/schemas/CfpbValidationLetterActionItem' created_at: type: string format: date-time nullable: true MessageResponse: type: object required: - message properties: message: type: string ValidationErrorResponse: type: object required: - message - errors properties: message: type: string errors: type: object additionalProperties: type: array items: type: string CfpbValidationLetterSnapshot: type: object additionalProperties: false required: - hidden - last_action_type - last_action_label - last_action_at - last_action_consumer_count - last_action_with_qr - last_action_cost properties: hidden: type: boolean last_action_type: type: string nullable: true enum: - download - eco_letter_send last_action_label: type: string nullable: true enum: - Download - EcoLetter Sent last_action_at: type: string format: date-time nullable: true last_action_consumer_count: type: integer nullable: true last_action_with_qr: type: boolean nullable: true last_action_cost: type: string nullable: true example: '5.00' CfpbValidationLetterUploadedBy: type: object additionalProperties: false required: - id - name properties: id: type: integer name: type: string CfpbValidationLetterActions: type: object additionalProperties: false required: - can_download_csv - can_send_secure_ecoletters - can_resend_secure_ecoletters - can_download_print_letters - can_delete properties: can_download_csv: type: boolean can_send_secure_ecoletters: type: boolean can_resend_secure_ecoletters: type: boolean can_download_print_letters: type: boolean can_delete: type: boolean CfpbValidationLetterActionItem: type: object additionalProperties: false required: - key - label - available properties: key: type: string enum: - download_csv - send_secure_ecoletters - resend_secure_ecoletters - download_print_letters - delete label: type: string enum: - Download CSV - Send Secure EcoLetters - Resend Secure EcoLetters - Download & Print Letters - Delete available: type: boolean responses: Unauthenticated: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' ActiveMembershipRequired: description: Authenticated creditor does not have an active membership. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' example: message: An active membership is required. NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/MessageResponse' ValidationError: description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Sanctum token ````