> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue Tax Invoice

> The sum of all item amounts becomes the issuance amount. Provide each item's tax (`tax`) according to `taxType`.

See the [Issuance amount guide](/en/docs/api-introduction/issuance-guide) for calculation details and the [Brokered Tax Invoice Issuance guide](/en/docs/api-introduction/usecase-brokered) for the brokered workflow.

The API removes invisible characters from the request text but keeps tabs, line feeds, and carriage returns. It rejects supplementary characters above U+FFFF, such as emoji, with `400`. See [Unsupported characters](/en/docs/api-introduction/issuance-guide#unsupported-characters).




## OpenAPI

````yaml /openapi.en.yaml post /v1/taxInvoices/issue
openapi: 3.1.0
info:
  title: Bolta API
  description: >
    The Bolta e-tax invoice API. [API
    Overview](/en/docs/api-introduction/overview) | [Authentication
    guide](/en/docs/api-introduction/authentication) | [Use
    cases](/en/docs/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: Bolta API server
security:
  - basicAuth: []
tags:
  - name: Tax Invoice Issuance
    description: >
      Issue and amend e-tax invoices. [Calculating the issuance
      amount](/en/docs/api-introduction/issuance-guide) | [Amendment
      types](/en/docs/api-introduction/amendment-guide)
  - name: Tax Invoice Retrieval
    description: >
      Retrieve e-tax invoice results and request processing status, and download
      the PDF of an issued tax invoice. [Tax invoice PDF
      guide](/en/docs/api-introduction/tax-invoice-pdf)
  - name: Reverse Issuance
    description: >
      Request and manage reverse issuance of e-tax invoices. [Email-approval
      reverse issuance](/en/docs/api-introduction/usecase-reverse-email) |
      [Simple-approval reverse
      issuance](/en/docs/api-introduction/usecase-reverse-simple)
  - name: Cash Receipt
    description: >
      Issue, cancel, and check the status of cash receipts. [Cash receipt
      guide](/en/docs/api-introduction/cash-receipt-guide) | [Cash receipt
      webhooks](/en/docs/api-introduction/webhook-cash-receipt)
  - name: Business Registration Status
    description: >
      Check the registration status and tax type of a business registration
      number. Look up one number or up to 100 numbers at once. This API requires
      no issuer registration and no certificate. [Business registration status
      guide](/en/docs/api-introduction/business-registration-status)
  - name: Revenue and Expense
    description: >
      Retrieve the revenue and expense tax invoices of your own business in
      Bolta in the order they changed, and request a collection. Responses
      include documents issued through Bolta and documents collected from
      Hometax. You need a Standard plan or higher, and the calls deduct no
      points. Connect Hometax in the Bolta dashboard first. [Revenue and expense
      guide](/en/docs/api-introduction/revenue-expense)
  - name: Bank Account Transactions
    description: >
      Retrieve the bank accounts and transactions connected to your own business
      in Bolta, and request a sync. You need a Standard plan or higher, and the
      calls deduct no points. Connect bank accounts in the Bolta dashboard
      first. [Bank account transactions
      guide](/en/docs/api-introduction/bank-account-transactions)
  - name: Bank Account Holder
    description: >
      Look up account holder names with a bank code and an account number. One
      path takes a single account and the other takes up to 100 accounts at
      once. Each account that returns a holder name deducts 50 points. [Bank
      account holder guide](/en/docs/api-introduction/bank-account-holder)
  - name: Document Issuance
    description: >
      Issue National Tax Service certificates from Hometax or a certified copy
      of corporate registry, and download the original PDF. Hometax documents
      are issued only for the business that owns the API key, and you must
      register a joint certificate in the Bolta dashboard. A corporate registry
      is issued for the corporation in `corporationNumber` and needs no joint
      certificate. Supported corporation types are stock company, limited
      company, general partnership company, limited partnership company, limited
      liability company, incorporated association, incorporated foundation,
      medical corporation, cooperative (including social cooperative), and other
      corporate entity (such as a patent corporation). Each document deducts 500
      points for Hometax documents, 1,000 points for a corporate registry view
      copy, and 1,500 points for a submission copy. [Document issuance
      guide](/en/docs/api-introduction/document-issuance)
  - name: Issuer
    description: >
      Register and manage businesses that act as tax invoice issuers.
      Certificate requirements depend on the issuance type.
      [Glossary](/en/docs/api-introduction/glossary) | [Delegated
      issuance](/en/docs/api-introduction/usecase-delegated) | [Brokered Tax
      Invoice Issuance](/en/docs/api-introduction/usecase-brokered)
  - name: Certificate
    description: >
      Register and manage issuer certificates. [Certificate
      registration](/en/docs/api-introduction/certificate-registration)
paths:
  /v1/taxInvoices/issue:
    post:
      tags:
        - Tax Invoice Issuance
      summary: Issue Tax Invoice
      description: >
        The sum of all item amounts becomes the issuance amount. Provide each
        item's tax (`tax`) according to `taxType`.


        See the [Issuance amount
        guide](/en/docs/api-introduction/issuance-guide) for calculation details
        and the [Brokered Tax Invoice Issuance
        guide](/en/docs/api-introduction/usecase-brokered) for the brokered
        workflow.


        The API removes invisible characters from the request text but keeps
        tabs, line feeds, and carriage returns. It rejects supplementary
        characters above U+FFFF, such as emoji, with `400`. See [Unsupported
        characters](/en/docs/api-introduction/issuance-guide#unsupported-characters).
      parameters:
        - $ref: '#/components/parameters/TaxInvoiceClientReferenceId'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaxInvoiceIssueRequest'
            examples:
              Standard taxable:
                x-parity-id: standardTaxable
                summary: Standard taxable tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    manager:
                      email: supplier@example.com
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                  items:
                    - date: '2026-07-28'
                      name: Taxable item
                      supplyCost: 100000
                      tax: 10000
              Foreign registration number:
                x-parity-id: foreignSupplied
                summary: Standard issuance to a foreign-registration-number recipient
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    taxRegistrationId: null
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    address: null
                    businessItem: Software
                    businessType: Service
                    manager:
                      email: supplier@example.com
                      name: Supplier Manager
                      telephone: null
                  supplied:
                    identificationNumber: '9001015234567'
                    taxRegistrationId: null
                    organizationName: Foreign Recipient
                    representativeName: Foreign Representative
                    address: null
                    businessItem: null
                    businessType: null
                    managers:
                      - email: foreign@example.com
                        name: Recipient Manager
                        telephone: null
                  items:
                    - date: '2026-05-27'
                      name: E-Tax Invoice Service
                      unitPrice: null
                      quantity: null
                      supplyCost: 100
                      tax: 10
                      specification: null
                      description: Foreign registration number standard issuance test
                  description: null
              Zero-rate issuance:
                x-parity-id: zeroRate
                summary: Zero-rate standard issuance
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: ZERO_RATE
                  supplier:
                    identificationNumber: '1234567890'
                    taxRegistrationId: null
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    address: null
                    businessItem: Software
                    businessType: Service
                    manager:
                      email: supplier@example.com
                      name: Supplier Manager
                      telephone: null
                  supplied:
                    identificationNumber: '0987654321'
                    taxRegistrationId: null
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    address: null
                    businessItem: null
                    businessType: null
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                        telephone: null
                  items:
                    - date: '2026-05-27'
                      name: Zero-rate item
                      unitPrice: null
                      quantity: null
                      supplyCost: 100000
                      tax: 0
                      specification: null
                      description: null
                  description: null
              Brokered taxable:
                x-parity-id: brokeredTaxable
                summary: Taxable brokered tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                    manager:
                      email: trustee@example.com
                      name: Trustee Manager
                      telephone: 010-1234-5678
                  items:
                    - date: '2026-07-28'
                      name: Taxable brokered item
                      supplyCost: 100000
                      tax: 10000
              Brokered zero-rate:
                x-parity-id: brokeredZeroRate
                summary: Zero-rate brokered tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: ZERO_RATE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                  items:
                    - date: '2026-07-28'
                      name: Zero-rate brokered item
                      supplyCost: 100000
                      tax: 0
              Brokered tax-free:
                x-parity-id: brokeredTaxFree
                summary: Tax-free brokered invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAX_FREE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                  items:
                    - date: '2026-07-28'
                      name: Tax-free brokered item
                      supplyCost: 100000
                      tax: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                required:
                  - issuanceKey
              example:
                issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE
          headers: {}
        '400':
          description: >-
            Request validation failed or the client reference ID was reused. An
            API key cannot reuse a `Bolta-Client-Reference-Id` it has already
            used, regardless of the request content. The response `code` is
            `INVALID_REQUEST`. The API returns the same code when the write date
            is past its issuance deadline. Check the deadline in advance with
            [Tax Invoice Issuance
            Deadline](/en/docs/api-introduction/tax-invoice-issue-due-date).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  parameters:
    TaxInvoiceClientReferenceId:
      name: Bolta-Client-Reference-Id
      in: header
      description: >-
        Client reference ID for a tax invoice request. This header is optional.
        Enter a non-blank value between 1 and 255 characters. After this value
        is used with a tax invoice issuance API, the same API key cannot reuse
        it, regardless of the request content or endpoint. A duplicate returns
        `400 Bad Request` with `INVALID_REQUEST`. If you do not receive a
        response, do not resend the request. Check the accepted request with the
        [request status
        API](/en/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-by-client-reference).
      required: false
      example: your-unique-reference-id
      schema:
        type: string
        minLength: 1
        maxLength: 255
        pattern: \S
  schemas:
    TaxInvoiceIssueRequest:
      type: object
      properties:
        date:
          title: Write date
          description: Write date
          allOf:
            - $ref: '#/components/schemas/DateString'
        purpose:
          $ref: '#/components/schemas/IssuancePurpose'
          title: Receipt/Claim type
          description: 'RECEIPT: receipt, CLAIM: claim'
        taxType:
          $ref: '#/components/schemas/TaxInvoiceTaxType'
        supplier:
          $ref: '#/components/schemas/TaxInvoiceSupplier'
          title: Supplier
          description: Supplier
        supplied:
          $ref: '#/components/schemas/TaxInvoiceRecipient'
          title: Supplied party
          description: Supplied party
        trustee:
          title: Trustee
          description: For brokered issuance, set the trustee information.
          anyOf:
            - $ref: '#/components/schemas/TaxInvoiceTrustee'
            - type: 'null'
        items:
          title: Items
          description: Items
          type: array
          items:
            $ref: '#/components/schemas/TaxInvoiceItem'
          minItems: 1
          maxItems: 16
        description:
          type:
            - string
            - 'null'
          title: Tax invoice note
          description: >-
            Tax invoice note. If the recipient's identification number is a
            foreign registration number, pass `null` or omit the field.
          minLength: 1
          maxLength: 150
      required:
        - purpose
        - taxType
        - supplied
        - supplier
        - items
        - date
      allOf:
        - $ref: '#/components/schemas/TaxInvoiceItemsByTaxTypeConstraint'
    IssuanceKey:
      type: string
      description: >-
        Issuance request identifier. Its format and length may change, so store
        the entire string as is.
      examples:
        - 8D529FAD3EBAE050B79CE943CCC7CEDE
    ErrorResponse:
      type: object
      description: The error response returned when an API request fails
      properties:
        code:
          type: string
          description: Error type identifier
        message:
          type: string
          description: Error description
        traceId:
          type: string
          description: Request trace identifier
      required:
        - code
        - message
        - traceId
    DateString:
      type: string
      format: date
      examples:
        - '2024-08-24'
    IssuancePurpose:
      type: string
      description: 'RECEIPT: receipt, CLAIM: claim'
      enum:
        - RECEIPT
        - CLAIM
    TaxInvoiceTaxType:
      type: string
      title: Tax type
      description: >-
        TAXABLE: taxable (e-tax invoice), ZERO_RATE: zero-rate (e-tax invoice),
        TAX_FREE: tax-exempt (invoice). For TAXABLE the item tax cannot be null;
        for ZERO_RATE every item's tax must be 0. For TAX_FREE every item's tax
        must be null or omitted.
      enum:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
      examples:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
    TaxInvoiceSupplier:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          title: Business registration number
          description: Business registration number
        taxRegistrationId:
          title: Sub-business place code
          description: Sub-business place code
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
          description: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
          description: Representative name
        address:
          title: Address
          description: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          description: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          description: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        manager:
          $ref: '#/components/schemas/TaxInvoiceManager'
          title: Manager
          description: Manager
      required:
        - identificationNumber
        - manager
        - organizationName
        - representativeName
    TaxInvoiceRecipient:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/RecipientIdentificationNumber'
          title: >-
            Identification number (business registration number, resident
            registration number, foreign registration number)
          description: >-
            Identification number (business registration number,
            resident-registration-number format, foreign-registration-number
            format)
        taxRegistrationId:
          title: Sub-business place code
          description: >-
            If the recipient's identification number is not a business
            registration number, pass `null` or omit the field.
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
          description: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
          description: Representative name
        address:
          title: Address
          description: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          description: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          description: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        managers:
          type: array
          items:
            $ref: '#/components/schemas/TaxInvoiceManager'
          title: Manager
          description: Manager
          minItems: 1
          maxItems: 2
      required:
        - representativeName
        - managers
        - identificationNumber
        - organizationName
    TaxInvoiceTrustee:
      type: object
      description: Trustee information for brokered tax invoice issuance.
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          title: Trustee business registration number
        taxRegistrationId:
          title: Sub-business place code
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
        address:
          title: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        manager:
          title: Trustee manager
          anyOf:
            - $ref: '#/components/schemas/TaxInvoiceTrusteeManager'
            - type: 'null'
      required:
        - identificationNumber
        - organizationName
        - representativeName
    TaxInvoiceItem:
      type: object
      properties:
        date:
          $ref: '#/components/schemas/DateString'
          title: Item supply date
          description: Item supply date
        name:
          type: string
          title: Item name
          description: Item name
          maxLength: 100
          minLength: 1
        unitPrice:
          type:
            - integer
            - 'null'
          title: Unit price
          description: Unit price
          minimum: 0
          exclusiveMinimum: 0
          examples:
            - 100
        quantity:
          type:
            - integer
            - 'null'
          title: Quantity
          description: Quantity
        supplyCost:
          type: integer
          title: Supply cost
          description: Supply cost
          minimum: 1
          examples:
            - 1000
        tax:
          type:
            - integer
            - 'null'
          title: Tax
          description: >-
            Tax. Pass a non-`null` value when `taxType` is `TAXABLE` and `0`
            when `ZERO_RATE`. When `TAX_FREE`, pass `null` or omit the field.
          minimum: 0
          examples:
            - 0
            - 100
        specification:
          type:
            - string
            - 'null'
          title: Specification
          description: Specification
          maxLength: 60
        description:
          type:
            - string
            - 'null'
          title: Item note
          description: Item note
          maxLength: 100
      required:
        - date
        - name
        - supplyCost
    TaxInvoiceItemsByTaxTypeConstraint:
      type: object
      allOf:
        - if:
            properties:
              taxType:
                const: TAXABLE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      type: integer
                  required:
                    - tax
        - if:
            properties:
              taxType:
                const: ZERO_RATE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      const: 0
                  required:
                    - tax
        - if:
            properties:
              taxType:
                const: TAX_FREE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      type: 'null'
    BusinessRegistrationNumber:
      type: string
      title: Business registration number
      description: >-
        A checksum-valid 10-digit number without hyphens (-). Pattern:
        `^\d{10}$`. Example numbers in the docs are placeholders that fail the
        checksum. Set a real business registration number.
      pattern: ^\d{10}$
      examples:
        - '1234567890'
    TaxRegistrationId:
      type: string
      title: Sub-business place code
      description: '4 digits, excluding `0000`. Pattern: `^(?!0{4})\d{4}$`'
      pattern: ^(?!0{4})\d{4}$
      examples:
        - '0001'
        - '0002'
      minLength: 4
      maxLength: 4
    OrganizationName:
      type: string
      title: Organization name
      description: Organization name
      maxLength: 70
      minLength: 1
    RepresentativeName:
      type: string
      title: Representative name
      description: Representative name
      minLength: 1
      maxLength: 30
    Address:
      type: string
      title: Address
      description: Address
      maxLength: 150
      minLength: 1
    BusinessItem:
      type: string
      title: Business item
      description: Business item
      maxLength: 100
      examples:
        - Software development and supply
      minLength: 1
    BusinessType:
      type: string
      title: Business type
      description: Business type
      maxLength: 100
      examples:
        - Information and communications
      minLength: 1
    TaxInvoiceManager:
      type: object
      properties:
        email:
          $ref: '#/components/schemas/Email'
          title: Email
          description: Email
        name:
          type:
            - string
            - 'null'
          title: Name
          description: Name
          maxLength: 30
          minLength: 1
        telephone:
          type:
            - string
            - 'null'
          title: Mobile phone number
          description: >-
            Mobile phone number. If you provide it, Bolta sends a KakaoTalk
            notification (AlimTalk) to the manager. Pattern: `^010-\d{4}-\d{4}$`
          maxLength: 20
          examples:
            - 010-1234-5678
          pattern: ^010-\d{4}-\d{4}$
      required:
        - email
    RecipientIdentificationNumber:
      type: string
      title: Identification number
      description: >-
        10-digit business registration number, 13-digit
        resident-registration-number format, or 13-digit
        foreign-registration-number format. Digits without hyphens (-). The
        example numbers are placeholders. Set the recipient's real
        identification number.
      pattern: ^\d{10}(\d{3})?$
      examples:
        - '1234567890'
        - '9001011234567'
        - '9001015234567'
    TaxInvoiceTrusteeManager:
      type: object
      description: Set at least one of `email`, `name`, or `telephone`.
      properties:
        email:
          anyOf:
            - $ref: '#/components/schemas/Email'
            - type: 'null'
        name:
          type:
            - string
            - 'null'
          maxLength: 30
          minLength: 1
        telephone:
          type:
            - string
            - 'null'
          maxLength: 20
          pattern: ^010-\d{4}-\d{4}$
      anyOf:
        - properties:
            email:
              $ref: '#/components/schemas/Email'
          required:
            - email
        - properties:
            name:
              type: string
              minLength: 1
              maxLength: 30
          required:
            - name
        - properties:
            telephone:
              type: string
              pattern: ^010-\d{4}-\d{4}$
              maxLength: 20
          required:
            - telephone
    Email:
      type: string
      title: Email
      description: >-
        Pattern:
        `^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
      format: email
      pattern: ^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
      maxLength: 40
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Append a colon to your API key, Base64-encode it, and put it in the
        header. Enter the API key as the username and leave the password empty.

````