openapi: 3.0.0
info:
  title: Receipts API
  version: v2
  description: |
    Generate billing receipts for users.
security:
  - basicAuth: []
paths:
  /v2/receipts:
    post:
      summary: Generate a receipt
      description: >-
        Returns a PDF listing all billable transactions associated with the
        user.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                user:
                  type: string
                  format: uuid
                  description: ID of the user.
              required:
                - user
            example:
              user: 018051aa-f7a9-a0db-2f38-6cfa325e9d69
      responses:
        '200':
          description: ''
          headers:
            Content-Type:
              description: Content type of response payload.
              schema:
                type: string
                example: application/pdf
            Content-Disposition:
              description: Response disposition with receipt filename.
              schema:
                type: string
                example: attachment; filename="receipt.pdf"
            Content-Length:
              description: Size of response payload in bytes.
              schema:
                type: integer
                example: 12345
          content:
            application/pdf:
              schema:
                type: string
                format: binary
              examples:
                default:
                  value: |
                    200 OK
                    Content-Type: application/pdf
                    Content-Disposition: attachment; filename="receipt.pdf"
                    Content-Length: 12345

                    [PDF binary stream omitted]
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Username = api_key_id, Password = api_key_secret