affordability.yml

openapi: 3.0.1
info:
  title: Affordability
  version: 3.0.0
  license:
    name: "commercial"
    url: https://basiq.io
servers:
- url: https://au-api.basiq.io
paths:
  /users/{userId}/affordability:
    get:
      tags:
      - Affordability
      summary: List affordability summaries
      description: Returns a list of affordability summaries that have been generated for a specific user.
      operationId: getAffordabilityList
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      responses:
        200:
          description: Returns a list with a data property that contains an array
            of affordability resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AffordabilityListResponse'
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
    post:
      tags:
      - Affordability
      summary: Create an affordability summaries
      description: Create an affordability summaries for a user
      operationId: postAffordability
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AffordabilityPostRequest'
        required: false
      responses:
        200:
          description: Returns a created affordability resource, if the operation
            succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AffordabilityResponse'
            application/pdf:
              schema:
                $ref: '#/components/schemas/AffordabilityResponse'
        201:
          description: Returns a created affordability PDF Report, if the operation
            succeeded.
          content: {}
        204:
          description: Returns no content if there are none transactions for the requested
            period.
          content: {}
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/affordability/{snapshotId}:
    get:
      tags:
      - Affordability
      summary: Retrieve an affordability summary
      description: Retrieves a specific, pre existing affordability summaries
      operationId: getAffordability
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      - name: snapshotId
        in: path
        description: The identifier of the affordability summaries to be retrieved.
        required: true
        schema:
          type: string
      responses:
        200:
          description: Returns a saved affordability resource JSON or PDF summary file,
            if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AffordabilityResponse'
            application/pdf:
              schema:
                $ref: '#/components/schemas/AffordabilityResponse'
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
            application/pdf:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/affordability/{snapshotId}/transactions:
    get:
      tags:
      - Affordability
      summary: List affordability summary transactions
      description: Use this endpoint to retrieve a paginated list of transactions associated with an affordability summary.
      operationId: getAffordabilitySnapshotTransactions
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      - name: snapshotId
        in: path
        description: The identifier of the affordability summary to be retrieved.
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: This represents the maximum number of transactions that may be
          included in the response (maximum of 500). Note that by default 500 transactions
          are returned if this value is not specified.
        schema:
          type: integer
      responses:
        200:
          description: Returns a affordability resource transactions JSON or CSV file,
            if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AffordabilityTransactionsResponse'
            application/csv:
              schema:
                $ref: '#/components/schemas/AffordabilityTransactionsResponse'
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
            application/csv:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
            application/csv:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
            application/csv:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
            application/csv:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/expenses:
    post:
      tags:
      - Expenses
      summary: Create an expense summary
      description: Create a new expense summary for a user
      operationId: postExpenses
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExpensesPostRequest'
        required: false
      responses:
        200:
          description: Returns a created expenses resource, if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExpensesResponse'
        204:
          description: Returns no content if there are none transactions for the requested
            period.
          content: {}
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/expenses/{snapshotId}:
    get:
      tags:
      - Expenses
      summary: Retrieve an expense summary
      description: Retrieve an existing expense summary for a specific user
      operationId: getExpenses
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      - name: snapshotId
        in: path
        description: The identifier of the expense summary to be retrieved.
        required: true
        schema:
          type: string
      responses:
        200:
          description: Returns a saved expenses resource, if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExpensesResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/ExpensesResponse'
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
            text/csv:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
            text/csv:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
            text/csv:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
            text/csv:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/income:
    post:
      tags:
      - Income
      summary: Create an income summary
      description: Create an income summary for a specific user
      operationId: postIncome
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IncomePostRequest'
        required: false
      responses:
        200:
          description: Returns a created income resource, if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IncomeResponse'
        204:
          description: Returns no content if there are none transactions for the requested
            period.
          content: {}
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
  /users/{userId}/income/{snapshotId}:
    get:
      tags:
      - Income
      summary: Retrieve an income summary
      description: Retrieve an existing income summary for a specific user
      operationId: getIncome
      deprecated: true
      parameters:
      - name: userId
        in: path
        description: The identifier of the user.
        required: true
        schema:
          type: string
      - name: snapshotId
        in: path
        description: The identifier of the income summary to be retrieved.
        required: true
        schema:
          type: string
      responses:
        200:
          description: Returns a saved income resource, if the operation succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IncomeResponse'
        400:
          description: Returns error that server cannot or will not process the request
            due to something that is perceived to be a client error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        403:
          description: Error that access is forbidden and tied to the application
            logic, such as insufficient rights to a resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenAccessError'
        404:
          description: Returns error indicating that server can't find requested resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        500:
          description: Returns error response code indicates that the server encountered
            an unexpected condition that prevented it from fulfilling the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
      security:
      - services_token: []
components:
  schemas:
    AccountType:
      required:
      - product
      - type
      type: object
      properties:
        product:
          type: string
          description: Identifies the Product as defined by institution
          example: Hooli Transaction
        type:
          type: string
          description: Identifies the Account type defined by institution
          example: transaction
    AffordabilityAssetsData:
      required:
      - account
      - availableFunds
      - balance
      - currency
      - institution
      - previous6Months
      - type
      type: object
      properties:
        type:
          type: string
          description: Type of account
          example: account
        account:
          $ref: '#/components/schemas/AccountType'
        availableFunds:
          type: string
          description: The available funds at the time of the query.
          example: "45670.98"
        balance:
          type: string
          description: The currency in which the account is recorded.
          example: "35298.67"
        currency:
          type: string
          description: The currency in which the account is recorded.
          example: "AUD"
        institution:
          type: string
          description: The name of the financial institution with whom the account
            is held.
          example: Hooli
        previous6Months:
          $ref: '#/components/schemas/AssetsPrevious6MonthsData'
    AffordabilityLinksInList:
      title: AffordabilityLinksInList
      required:
      - expenses
      - income
      - self
      type: object
      properties:
        expenses:
          type: string
          description: Link to the expenses
          example: "https://au-api.basiq.io/users/25c8d1ed77/expenses/s55bf5"
        income:
          type: string
          description: Link to the income
          example: "https://au-api.basiq.io/users/25c8d1ed77/income/s55bf4"
        self:
          type: string
          description: Link to the affordability resource
          example: "https://au-api.basiq.io/users/25c8d1ed77/affordability/s55bf3"
      description: Object containing links to resources.
    AffordabilityListData:
      required:
      - fromMonth
      - generatedDate
      - id
      - links
      - toMonth
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "affordability".
          example: affordability
        id:
          type: string
          description: Uniquely identifies the affordability summary.
          example: s55bf3
        coverageDays:
          type: integer
          description: Number of days covered by the summary
          format: int64
          example: 392
        fromMonth:
          type: string
          description: Start month for the period for which the Affordability summary
            is generated. The period of time relates to the account and transaction
            data used as input into the summary.
          example: "2019-03"
        toMonth:
          type: string
          description: End month (usually the current month) for the period for which
            the Affordability summary is generated.
          example: "2020-03"
        generatedDate:
          type: string
          description: Date the summary was generated.
          example: "2020-03-26T06:56:44"
        institutions:
          type: array
          description: An array of institution ids to indicate the sources of transaction
            data, aggregated to generate the affordability resource.
          example: AU00000
          items:
            type: string
        links:
          $ref: '#/components/schemas/AffordabilityLinksInList'
    AffordabilityListLinks:
      required:
      - self
      type: object
      properties:
        self:
          type: string
          description: Link to the requested user affordability resources
          example: "https://au-api.basiq.io/users/25c8d1ed77/affordability"
    AffordabilityListResponse:
      title: AffordabilityListResponse
      required:
      - data
      - links
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "List".
          example: list
        data:
          type: array
          items:
            $ref: '#/components/schemas/AffordabilityListData'
        links:
          $ref: '#/components/schemas/AffordabilityListLinks'
      description: Container object, containing affordability list details.
    AffordabilityPostRequest:
      type: object
      properties:
        accounts:
          type: array
          description: The list of accounts to be included in the affordability otherwise
            all the user accounts will be included in the summary
          example:
          - s55bf3
          - s55bf4
          items:
            type: string
        fromMonth:
          type: string
          description: The first/start month to be included in the affordability output
            e.g. "fromMonth":"2019-05". Resulting affordability resource will be based
            on data between fromMonth and toMonth.
          example: "2019-05"
        toMonth:
          type: string
          description: The last/end month to be included in the affordability output
            e.g. "toMonth":"2019-09". Resulting affordability resource will be based
            on data between fromMonth and toMonth.
          example: "2019-09"
    AffordabilityRegularIncomeData:
      required:
      - previous3Months
      type: object
      properties:
        previous3Months:
          $ref: '#/components/schemas/AvgMonthlyData'
    AffordabilityResponse:
      title: AffordabilityResponse
      required:
      - assets
      - external
      - fromMonth
      - generatedDate
      - id
      - liabilities
      - links
      - summary
      - toMonth
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "affordability".
          example: affordability
        id:
          type: string
          description: Uniquely identifies the affordability summary.
          example: s55bf3
        coverageDays:
          type: integer
          description: Number of days covered by the summary
          format: int64
          example: 392
        assets:
          type: array
          description: Assets
          items:
            $ref: '#/components/schemas/AffordabilityAssetsData'
        external:
          type: array
          description: External
          items:
            $ref: '#/components/schemas/ExternalLiabilityData'
        fromMonth:
          type: string
          description: Start month for the period for which the Affordability summary
            is generated. The period of time relates to the account and transaction
            data used as input into the summary.
          example: "2019-03"
        toMonth:
          type: string
          description: End month (usually the current month) for the period for which
            the Affordability summary is generated.
          example: "2020-03"
        generatedDate:
          type: string
          description: Date the summary was generated.
          example: "2020-03-26T06:56:44"
        liabilities:
          $ref: '#/components/schemas/LiabilitiesData'
        summary:
          $ref: '#/components/schemas/AffordabilitySummary'
        links:
          $ref: '#/components/schemas/GetAffordabilityLinks'
      description: |-
        Container object, containing affordability details.

        The affordability object includes a summary of financial position, assets, liabilities, with links to an income object and an expenses object, for an individual user for account and transaction data stored against that user.
    AffordabilitySummary:
      required:
      - assets
      - creditLimit
      - expenses
      - liabilities
      - loanRepaymentMonthly
      - netPosition
      - potentialLiabilitiesMonthly
      - regularIncome
      - savings
      type: object
      properties:
        assets:
          type: string
          description: Total of cash based assets
          nullable: true
          example: "59983.11"
        creditLimit:
          type: string
          description: Total credit limit across all credit cards and overdrafts
          nullable: true
          example: "20000.00"
        expenses:
          type: string
          description: Provides an average of monthly expenses calculated for the
            whole period of data retrieved (e.g. 13 months)
          example: "-12046.00"
        liabilities:
          type: string
          description: Total of account based liabilities split into credit and loan
            liabilities
          nullable: true
          example: "-323946.20"
        loanRepaymentMonthly:
          type: string
          description: Total of all repayments monthly to disclosed loan liabilities
            as an average monthly amount
          nullable: true
          example: "5284.00"
        netPosition:
          type: string
          description: Total assets minus total liabilities
          nullable: true
          example: -263963.09
        potentialLiabilitiesMonthly:
          type: string
          description: Total of all repayments monthly to potential undisclosed loan
            liabilities as an average monthly amount
          nullable: true
          example: -1727.00
        regularIncome:
          $ref: '#/components/schemas/AffordabilityRegularIncomeData'
        savings:
          type: string
          description: Average of monthly savings calculated for the whole period
            of data retrieved (e.g. 13 months)
          nullable: true
          example: "93.00"
    subClassAffordability:
      required:
      - title
      - Code
      type: object
      properties:
        title:
          type: string
          description: The subClass attribute will only return values for payment transactions (i.e. will be empty for all others) ( [affordability only] - HEC classification class is returned by default or custom class is returned if configured - ask us about custom category mapping)
          example: Formal child care services nec
        Code:
          type: integer
          description: The subClass attribute will only return values for payment transactions (i.e. will be empty for all others) ( [affordability only] - HEC classification class is returned by default or custom class is returned if configured - ask us about custom category mapping)
          example: 0801050199

    AffordabilityTransactionLinks:
      required:
      - account
      - institution
      type: object
      properties:
        account:
          type: string
          description: Url of the account.
          example: "https://au-api.basiq.io/users/6a52015e/accounts/31eb30a0"
        institution:
          type: string
          description: Url of the institution.
          example: "https://au-api.basiq.io/institutions/AU00000"
    AffordabilityTransactionsGetLinks:
      required:
      - self
      type: object
      properties:
        self:
          type: string
          description: Self reference url.
          example: "https://au-api.basiq.io/users/115dc708/affordability/9dedbb28/transactions"
        next:
          type: string
          description: Url to next result.
          example: "https://au-api.basiq.io/users/115dc708/affordability/9dedbb28/transactions?next=9b7d9a64"
    AffordabilityTransactionsResponse:
      title: AffordabilityTransactionsResponse
      required:
      - count
      - data
      - links
      - size
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "list".
          example: list
        count:
          type: integer
          description: Count of the transactions in the response.
          format: int64
          example: 100
        size:
          type: integer
          format: int64
          example: 500
        data:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDataAffordability'
        links:
          $ref: '#/components/schemas/AffordabilityTransactionsGetLinks'
      description: Container object, containing affordability snapshot transaction.
    AssetsPrevious6MonthsData:
      required:
      - maxBalance
      - minBalance
      type: object
      properties:
        maxBalance:
          type: string
          nullable: true
          example: "38309.44"
        minBalance:
          type: string
          nullable: true
          example: "10032.81"
    AvgMonthlyData:
      required:
      - avgMonthly
      type: object
      properties:
        avgMonthly:
          type: string
          nullable: true
          example: "18098.00"
    BadRequestError:
      required:
      - correlationId
      - data
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "list".
          example: list
        correlationId:
          type: string
          description: Unique identifier for this particular occurrence of the problem.
          example: ac5ah5i
        data:
          type: array
          description: Error data.
          items:
            required:
            - code
            - type
            type: object
            properties:
              code:
                type: string
                description: Application-specific error code, expressed as a string
                  value.
                example: parameter-not-valid
                enum:
                - parameter-not-supplied
                - parameter-not-valid
                - unsupported-accept
                - invalid-content
                - institution-not-supported
                - invalid-credentials
              detail:
                type: string
                description: Human-readable explanation specific to this occurrence
                  of the problem.
                example: ID value is not valid.
              source:
                $ref: '#/components/schemas/Source'
              title:
                type: string
                description: Title of the error
                example: Parameter not valid.
              type:
                type: string
                description: Type of the response, always "error"
                example: error
    CategoryDataExpenses:
      required:
      - expenseClass
      type: object
      properties:
        expenseClass:
          $ref: '#/components/schemas/ExpensesClass'
      description: Category data
    ChangeHistoryAffordabilityData:
      required:
      - amount
      - date
      - direction
      - source
      type: object
      properties:
        amount:
          type: string
          description: Amount loan-interest or loan-repayment
          example: "5768.00"
        date:
          type: string
          description: Date
          format: date
          example: "2019-03-31"
        direction:
          type: string
          description: Debit or Credit
          example: credit
          enum:
          - debit
          - credit
        source:
          type: string
          description: Cleaned transaction description
          example: Transfer Platnm Homeloan 346454
    ChangeHistoryExpensesClass:
      required:
      - amount
      - date
      type: object
      properties:
        amount:
          type: string
          description: Amount of expense that period
          example: "-11.00"
        date:
          type: string
          description: Month expense relates
          example: "2018-09"
      description: Amount classified as spent that month (repeated each month of data)
    ChangeHistoryExternal:
      required:
      - amount
      - date
      - source
      type: object
      properties:
        amount:
          type: string
          description: Amount of payment
          example: "-146.50"
        date:
          type: string
          description: Date
          format: date
          example: "2019-03-31"
        source:
          type: string
          description: Full transaction description
          example: 'AFTERPAY MELBOURNE VI AUS Card xx3854 Value Date: 10/11/2019'
    ChangeHistoryIncome:
      required:
      - amount
      - date
      - source
      type: object
      properties:
        amount:
          type: string
          description: Amount of income for that period
          example: "62.00"
        date:
          type: string
          description: Date income received
          example: "2018-10-13T20:03:37"
        source:
          type: string
          description: Source income (cleaned transaction description)
          example: savings interest cr bal - Account 1
    ClassResourceExpenses:
      required:
      - avgMonthly
      - changeHistory
      - summary
      type: object
      properties:
        avgMonthly:
          type: string
          description: Average amount monthly
          example: "-421.00"
        changeHistory:
          type: array
          items:
            $ref: '#/components/schemas/ChangeHistoryExpensesClass'
        summary:
          type: string
          description: Summary period "monthly"
          example: monthly
      description: Average monthly amount for given class for defined period
    CreditLiabilities:
      required:
      - account
      - availableFunds
      - balance
      - creditLimit
      - currency
      - institution
      - previous6Months
      - previousMonth
      type: object
      properties:
        account:
          $ref: '#/components/schemas/AccountType'
        availableFunds:
          type: string
          description: The available funds at the time of the query.
          nullable: true
          example: "8286.80"
        balance:
          type: string
          description: The balance at the time of the query.
          nullable: true
          example: "-11713.20"
        creditLimit:
          type: string
          description: Total credit limit available for the specified credit facility.
          nullable: true
          example: "20000.00"
        currency:
          type: string
          description: The currency in which the account is recorded.
          example: AUD
        institution:
          type: string
          description: The name of the financial institution with whom the account
            is held.
          example: Hooli
        previous6Months:
          $ref: '#/components/schemas/Previous6MonthsCreditLiabilities'
        previousMonth:
          $ref: '#/components/schemas/PreviousMonthDataLiabilities'
    CurrentIrregularSource:
      required:
      - amount
      - date
      type: object
      properties:
        amount:
          type: string
          description: Most recent irregular income payment amount
          example: "62.00"
        date:
          type: string
          description: Most recent irregular income payment date
          example: "2018-10-13T20:03:37"
    CurrentOtherCreditSource:
      required:
      - amount
      - date
      - otherCreditLabel
      type: object
      properties:
        amount:
          type: string
          description: Most recent irregular income payment amount
          example: "92.99"
        date:
          type: string
          description: Most recent irregular income payment date
          example: "2019-10-29T00:00:00"
        otherCreditLabel:
          type: string
          description: Description of the other credit series e.g. 'former regular
            income'
          example: regular income small amount
    CurrentRegularSource:
      required:
      - amount
      - date
      - nextDate
      type: object
      properties:
        amount:
          type: string
          description: Most recent regular income payment amount
          example: "18098.00"
        date:
          type: string
          description: Most recent regular income payment date
          example: "2018-11-30T09:23:37"
        nextDate:
          type: string
          description: 'Predicted next occurrence for regular income (note: where
            the pattern has recently ceased there would be no predicted next occurrence)'
          nullable: true
          example: "2018-12-30T18:30:49"
    ExpensesClass:
      required:
      - classCode
      - classTitle
      - divisionCode
      - divisionTitle
      type: object
      properties:
        classCode:
          type: string
          description: 'Classification code for HEC classification: 4 levels class,
            group, subdivision and division.'
          example: "0703030101"
        classTitle:
          type: string
          description: 'Classification code for HEC classification: 4 levels class,
            group, subdivision and division.'
          example: Non-electrical household appliances
        divisionCode:
          type: string
          example: "04"
        divisionTitle:
          type: string
          example: Alcoholic beverages
      description: Class represents one class of classification system
    ExpensesLinks:
      required:
      - accounts
      - self
      type: object
      properties:
        accounts:
          type: array
          description: Links of accounts
          example:
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf5"
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf4"
          items:
            type: string
        self:
          type: string
          description: Link to the requested expenses resource
          example: "https://au-api.basiq.io/users/25c8d1ed77/expenses/s55bf4"
    ExpensesPostRequest:
      type: object
      properties:
        accounts:
          type: array
          description: The list of accounts to be included in the expenses otherwise
            all the user accounts will be included in the summary
          example:
          - s55bf3
          - s55bf4
          items:
            type: string
        fromMonth:
          type: string
          description: The first/start month to be included in the expense output
            e.g. "fromMonth":"2019-05". Resulting expenses resource will be based
            on data between fromMonth and toMonth.
          example: "2019-05"
        toMonth:
          type: string
          description: The last/end month to be included in the expense output e.g.
            "toMonth":"2019-09". Resulting expenses resource will be based on data
            between fromMonth and toMonth.
          example: "2019-09"
    ExpensesResponse:
      title: ExpensesResponse
      required:
      - bankFees
      - cashWithdrawals
      - externalTransfers
      - fromMonth
      - id
      - loanInterests
      - loanRepayments
      - payments
      - toMonth
      - type
      type: object
      properties:
        type:
          type: string
          description: Value of this resource is "expenses".
          example: expenses
        id:
          type: string
          description: Uniquely identifies the expenses summary.
          example: s55bf3
        coverageDays:
          type: integer
          description: Number of days covered by the summary
          format: int64
          example: 392
        bankFees:
          $ref: '#/components/schemas/ClassResourceExpenses'
        cashWithdrawals:
          $ref: '#/components/schemas/ClassResourceExpenses'
        externalTransfers:
          $ref: '#/components/schemas/ClassResourceExpenses'
        fromMonth:
          type: string
          description: First 'month' occurrence of expenses categorised going back
            as far as 13 months.
          example: "2017-12"
        loanInterests:
          $ref: '#/components/schemas/ClassResourceExpenses'
        loanRepayments:
          $ref: '#/components/schemas/ClassResourceExpenses'
        payments:
          type: array
          items:
            $ref: '#/components/schemas/PaymentsSummaryExpenses'
        toMonth:
          type: string
          description: Latest 'month' occurrence of expenses categorised.
          example: "2018-12"
        links:
          $ref: '#/components/schemas/ExpensesLinks'
      description: |-
        Container object, containing expenses details.

        The Expenses object returns an aggregated list of expenses by category of spend.
    ExternalLiabilityData:
      required:
      - changeHistory
      - payments
      - source
      type: object
      properties:
        changeHistory:
          type: array
          description: Each transaction (repeated for each source ordered by most
            recent)
          items:
            $ref: '#/components/schemas/ChangeHistoryExternal'
        payments:
          type: array
          description: Aggregated attributes relating to payments for this source
            (identified as an external liability)
          items:
            $ref: '#/components/schemas/ExternalPayment'
        source:
          type: string
          description: Source of external liability (cleaned transaction description).
          example: afterpay
    ExternalPayment:
      required:
      - amountAvg
      - amountAvgMonthly
      - first
      - last
      - noOccurrences
      - total
      type: object
      properties:
        amountAvg:
          type: string
          description: Number of occurrences for same source (in this group)
          example: "-50.50"
        amountAvgMonthly:
          type: string
          description: Average monthly payment amount
          example: "-20.00"
        first:
          type: string
          description: Date of first payment
          format: date
          example: "2019-03-15"
        last:
          type: string
          description: Date of last payment
          format: date
          example: "2020-03-15"
        noOccurrences:
          type: integer
          description: Number of occurrences for same source (in this group)
          format: int64
          example: 2
        total:
          type: string
          description: Amount of total payments identified for source in the affordability
            snapshot
          example: "-146.50"
    ForbiddenAccessError:
      required:
      - correlationId
      - data
      - type
      type: object
      properties:
        correlationId:
          type: string
          description: Unique identifier for this particular occurrence of the problem.
          example: ac5ah5i
        data:
          type: array
          description: Error data.
          items:
            required:
            - code
            - source
            - type
            type: object
            properties:
              code:
                type: string
                description: Application-specific error code, expressed as a string
                  value.
                example: forbidden-access
                enum:
                - forbidden-access
                - no-production-access
                - access-denied
              detail:
                type: string
                description: Human-readable explanation specific to this occurrence
                  of the problem.
                example: Access to this resource is forbidden.
              source:
                $ref: '#/components/schemas/Source'
              title:
                type: string
                description: Title of the error
                example: Forbidden Access
              type:
                type: string
                description: Type of the response, always "error"
                example: error
        type:
          type: string
          description: Always "list".
          example: list
    Gap:
      type: string
    GetAffordabilityLinks:
      title: GetAffordabilityLinks
      required:
      - accounts
      - expenses
      - income
      - self
      type: object
      properties:
        accounts:
          type: array
          description: Links of accounts
          example:
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf5"
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf4"
          items:
            type: string
        expenses:
          type: string
          description: Link to the expenses
          example: "https://au-api.basiq.io/users/25c8d1ed77/expenses/s55bf5"
        income:
          type: string
          description: Link to the income
          example: "https://au-api.basiq.io/users/25c8d1ed77/income/s55bf4"
        self:
          type: string
          description: Link to the affordability resource
          example: "https://au-api.basiq.io/users/25c8d1ed77/affordability/s55bf3"
      description: Object containing links to resources.
    IncomeLinks:
      required:
      - accounts
      - self
      type: object
      properties:
        accounts:
          type: array
          description: Links of accounts
          example:
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf5"
          - "https://au-api.basiq.io/users/25c8d1ed77/accounts/s55bf4"
          items:
            type: string
        self:
          type: string
          description: Link to the requested income resource
          example: "https://au-api.basiq.io/users/25c8d1ed77/income/s55bf4"
    IncomePostRequest:
      type: object
      properties:
        accounts:
          type: array
          description: The list of accounts to be included in the income otherwise
            all the user accounts will be included in the summary
          example:
          - s55bf3
          - s55bf4
          items:
            type: string
        fromMonth:
          type: string
          description: The first/start month to be included in the affordability output
            e.g. "fromMonth":"2019-05". Resulting income resource will be based on
            data between fromMonth and toMonth
          example: "2019-05"
        toMonth:
          type: string
          description: The first/start month to be included in the affordability output
            e.g. "fromMonth":"2019-05". Resulting income resource will be based on
            data between fromMonth and toMonth
          example: "2019-09"
    IncomeResponse:
      title: IncomeResponse
      required:
      - fromMonth
      - id
      - summary
      - toMonth
      - type
      type: object
      properties:
        type:
          type: string
          description: Always "income".
          example: income
        id:
          type: string
          description: The identifier of the income resource to be retrieved.
          example: s55bf4
        coverageDays:
          type: integer
          description: Number of days covered by the summary
          format: int64
          example: 392
        fromMonth:
          type: string
          description: Start month for the period for which the Income summary is
            generated. The period of time relates to the account and transaction data
            used as input into the summary.
          example: "2019-03"
        toMonth:
          type: string
          description: End month (usually the current month) for the period for which
            the Income summary is generated.
          example: "2020-03"
        regular:
          type: array
          description: Required true
          items:
            $ref: '#/components/schemas/RegularSource'
        irregular:
          type: array
          description: Required true
          items:
            $ref: '#/components/schemas/IrregularSource'
        otherCredit:
          type: array
          description: Required true
          items:
            $ref: '#/components/schemas/OtherCreditSource'
        summary:
          $ref: '#/components/schemas/IncomeSummary'
        links:
          $ref: '#/components/schemas/IncomeLinks'
      description: |-
        Container object, containing income details.

        The Income Summary object with income summarised and classified by type: regular, irregular or other sources (created/refreshed across up to 10 institutions)
    IncomeSummary:
      required:
      - irregularIncomeAvg
      - regularIncomeAvg
      - regularIncomeYTD
      - regularIncomeYear
      type: object
      properties:
        irregularIncomeAvg:
          type: string
          description: Total mean of irregular income monthly calculated across the
            whole time period for all irregular sources
          nullable: true
          example: "55.00"
        regularIncomeAvg:
          type: string
          description: Total median regular income monthly calculated over the past
            3 months for all regular sources
          nullable: true
          example: "18098.00"
        regularIncomeYTD:
          type: string
          description: Total regular income so far this financial year (year to date)
          nullable: true
          example: "90490.00"
        regularIncomeYear:
          type: string
          description: "Coming soon: total predicted regular income for this financial year"
          nullable: true
          example: null
      description: Summary totals relating to income analysis
    InternalServerError:
      required:
      - correlationId
      - data
      - type
      type: object
      properties:
        correlationId:
          type: string
          description: Unique identifier for this particular occurrence of the problem.
          example: ac5ah5i
        data:
          type: array
          description: Error data.
          items:
            required:
            - code
            - type
            type: object
            properties:
              code:
                type: string
                description: Application-specific error code, expressed as a string
                  value.
                example: internal-server-error
                enum:
                - internal-server-error
              detail:
                type: string
                description: Human-readable explanation specific to this occurrence
                  of the problem.
                example: Internal Server error. Contact support.
              title:
                type: string
                description: Title of the error
                example: Internal Server error.
              type:
                type: string
                description: Type of the response, always "error"
                example: error
        type:
          type: string
          description: Always "list".
          example: list
    IrregularSource:
      required:
      - ageDays
      - amountAvg
      - avgMonthlyOccurence
      - changeHistory
      - current
      - frequency
      - noOccurrences
      - source
      type: object
      properties:
        ageDays:
          type: integer
          description: Duration irregular income (number days from first to last occurrence)
            returned as an integer with values zero or greater.
          format: int64
          example: 334
        amountAvg:
          type: string
          description: Mean of irregular income amount - calculated across all occurrences
            identified.
          example: "55.00"
        avgMonthlyOccurence:
          type: string
          description: Average (mean) number of times per calendar month the credits
            in the series occur.
          example: "1"
        changeHistory:
          type: array
          description: Each amount classified as income (repeated for each income
            credit and ordered by most recent)
          items:
            $ref: '#/components/schemas/ChangeHistoryIncome'
        current:
          $ref: '#/components/schemas/CurrentIrregularSource'
        frequency:
          type: string
          description: Frequency is "irregular"
          example: irregular
        noOccurrences:
          type: integer
          description: Number of instances of credits in the series.
          format: int64
          example: 5
        source:
          type: string
          description: Source irregular income (cleaned transaction description).
          example: ctrlink carers 998r6789201610974v
      description: |-
        IrregularSource
        Income sources typically require at least 5 credits across a minimum 90 day time period
    IrregularityIncome:
      required:
      - gaps
      - stability
      type: object
      properties:
        gaps:
          type: array
          description: Array of dates for which the expected credit is not met
          example:
          - 2020-03
          items:
            $ref: '#/components/schemas/Gap'
        stability:
          type: string
          description: Stability percentage indicator of how stable the income is.
            100 = no gaps in the income series from the source. Calculated as (number
            of transactions that are included in the income summary for this source)
            / (number of transactions that were expected to be included in the income
            summary for this source).
          example: "100.00"
    LiabilitiesData:
      required:
      - credit
      - loan
      type: object
      properties:
        credit:
          type: array
          description: Credit Liabilities
          items:
            $ref: '#/components/schemas/CreditLiabilities'
        loan:
          type: array
          description: Loan Liabilities
          items:
            $ref: '#/components/schemas/LoanLiabilities'
    LoanLiabilities:
      required:
      - account
      - availableFunds
      - balance
      - changeHistory
      - currency
      - institution
      - previous6Months
      - previousMonth
      type: object
      properties:
        account:
          $ref: '#/components/schemas/AccountType'
        availableFunds:
          type: string
          description: The available funds at the time of the query.
          nullable: true
          example: "87767.00"
        balance:
          type: string
          description: The balance at the time of the query.
          nullable: true
          example: "-312233.00"
        changeHistory:
          type: array
          description: List of account transactions changes
          items:
            $ref: '#/components/schemas/ChangeHistoryAffordabilityData'
        currency:
          type: string
          description: The currency in which the account is recorded.
          example: AUD
        institution:
          type: string
          description: The name of the financial institution with whom the account
            is held.
          example: Hooli
        previous6Months:
          $ref: '#/components/schemas/Previous6MonthsLoan'
        previousMonth:
          $ref: '#/components/schemas/PreviousMonthDataLoanLiabilities'
    NotFoundError:
      required:
      - correlationId
      - data
      - type
      type: object
      properties:
        correlationId:
          type: string
          description: Unique identifier for this particular occurrence of the problem.
          example: ac5ah5i
        data:
          type: array
          description: Error data.
          items:
            required:
            - code
            - type
            type: object
            properties:
              code:
                type: string
                description: Application-specific error code, expressed as a string
                  value.
                example: resource-not-found
                enum:
                - resource-not-found
              detail:
                type: string
                description: Human-readable explanation specific to this occurrence
                  of the problem.
                example: Resource not found.
              title:
                type: string
                description: Title of the error
                example: Requested resource is not found.
              type:
                type: string
                description: Type of the response, always "error"
                example: error
        type:
          type: string
          description: Always "list".
          example: list
    OtherCreditSource:
      required:
      - ageDays
      - amountAvg
      - avgMonthlyOccurence
      - changeHistory
      - current
      - frequency
      - noOccurrences
      - source
      type: object
      properties:
        ageDays:
          type: integer
          description: Duration other income (number days from first to last occurrence)
            returned as an integer with values zero or greater.
          format: int64
          example: 335
        amountAvg:
          type: string
          description: Mean of irregular income amount - calculated across all occurrences
            identified.
          example: "110.85"
        avgMonthlyOccurence:
          type: string
          description: Average (mean) number of times per calendar month the credits
            in the series occur.
          example: "1"
        changeHistory:
          type: array
          description: Each amount classified as income (repeated for each income
            credit and ordered by most recent)
          items:
            $ref: '#/components/schemas/ChangeHistoryIncome'
        current:
          $ref: '#/components/schemas/CurrentOtherCreditSource'
        frequency:
          type: string
          description: Frequency is "other", "irregular" or a time period e.g. "bi-weekly"
          example: monthly
          enum:
          - daily
          - weekly
          - bi-weekly
          - monthly
          - bi-monthly
          - quarterly
          - half-year
          - yearly
          - other
          - irregular
        noOccurrences:
          type: integer
          description: Number of instances of credits in the series.
          format: int64
          example: 12
        source:
          type: string
          description: Source Other Credit income (cleaned transaction description).
          example: savings interest cr bal - Account 1
      description: Other Credit Series are series where a pattern of credit is detected
        but the pattern does not meet the requirements for regular or irregular income,
        or the income series is too old e.g. former regular income or a potential
        future income
    PaymentsSummaryExpenses:
      required:
      - avgMonthly
      - division
      - percentageTotal
      - subCategory
      type: object
      properties:
        avgMonthly:
          type: string
          description: 'Average monthly amount by category for defined period (up
            to 13 months). This number monthly is calculated as follows: (Total Expenses/Report
            Coverage Days)*30. This allows data with partial months to be calculated
            correctly.'
          example: "-636.88"
        division:
          type: string
          description: 'Top level summary: category name. e.g. Medical care and heath
            expenses, Food and non-alcoholic beverages, Education'
          example: Education
        percentageTotal:
          type: number
          description: Average monthly amount expressed as a percentage of total expenses.
          format: double
          example: "-636.88"
        subCategory:
          type: array
          items:
            $ref: '#/components/schemas/SubCategoryExpenses'
      description: Payments Summary
    Previous3MonthsIncome:
      required:
      - amountAvg
      - amountAvgMonthly
      - variance
      type: object
      properties:
        amountAvg:
          type: string
          description: 'Median regular income amount - calculated across all occurrences
            in last 3 months (note: median provides a more reliable amount than mean
            for a regular income source as it is less affected by outliers and skewed
            data - use variance amount to understand outliers and changeHistory to
            view actual credits)'
          example: "18098.00"
        amountAvgMonthly:
          type: string
          description: Median monthly regular income amount
          example: "18098.00"
        variance:
          type: string
          description: Difference between min and max payment amount for regular income
          example: "0.00"
    Previous6MonthsCreditLiabilities:
      required:
      - cashAdvances
      type: object
      properties:
        cashAdvances:
          type: string
          description: Value of cash advances in period
          example: -2053.50
    Previous6MonthsLoan:
      required:
      - arrears
      type: object
      properties:
        arrears:
          type: string
          description: Has the loan been in arrears in the past 6 months - returned
            as a string value (true or false or null)
          nullable: true
          example: "true"
    PreviousMonthDataLiabilities:
      required:
      - maxBalance
      - minBalance
      - totalCredits
      - totalDebits
      type: object
      properties:
        maxBalance:
          type: string
          example: -12329.16
        minBalance:
          type: string
          example: -3174.16
        totalCredits:
          type: string
          example: "0.00"
        totalDebits:
          type: string
          example: -8287.10
    PreviousMonthDataLoanLiabilities:
      required:
      - totalCredits
      - totalDebits
      - totalInterestCharged
      - totalRepayments
      type: object
      properties:
        totalCredits:
          type: string
          example: "0.00"
        totalDebits:
          type: string
          example: -8287.10
        totalInterestCharged:
          type: string
          example: -4303.50
        totalRepayments:
          type: string
          example: "5768.00"
    RegularSource:
      required:
      - source
      - ageDays
      - changeHistory
      - current
      - frequency
      - irregularity
      - previous3Months
      type: object
      properties:
        source:
          type: string
          description: Source regular income (cleaned transaction description).
          example: payroll wfrms 15439393
        ageDays:
          type: integer
          description: Duration regular income (number days from first to last occurrence)
            returned as an integer with values zero or greater
          format: int64
          example: 334
        changeHistory:
          type: array
          description: Each amount classified as income (repeated for each income
            credit and ordered by most recent)
          items:
            $ref: '#/components/schemas/ChangeHistoryIncome'
        current:
          $ref: '#/components/schemas/CurrentRegularSource'
        frequency:
          type: string
          description: Enum detailing frequency regular income
          example: monthly
          enum:
          - daily
          - weekly
          - bi-weekly
          - monthly
          - bi-monthly
          - quarterly
          - half-year
          - yearly
        irregularity:
          $ref: '#/components/schemas/IrregularityIncome'
        previous3Months:
          $ref: '#/components/schemas/Previous3MonthsIncome'
      description: |-
        RegularSource
        Our complex income algorithm uses over 50 rules to identify different types of income sources. For example, to identify a regular income source - the fortnightly salary should have a minimum of 5 credits across a 90 day time period with regular intervals. Additionally, tolerances are applied based on confidence in identified income source patterns (by amount and frequency).
    Source:
      title: Source
      type: object
      properties:
        parameter:
          type: string
          description: String indicating which URI query parameter caused the error.
          example: userId
        pointer:
          type: string
          description: Location to the object or attribute that the error relates
            to.
          example: users/userId
      description: An object containing references to the source of the error.
    SubCategoryExpenses:
      required:
      - category
      - changeHistory
      - summary
      type: object
      properties:
        category:
          $ref: '#/components/schemas/CategoryDataExpenses'
        changeHistory:
          type: array
          items:
            $ref: '#/components/schemas/ChangeHistoryExpensesClass'
        summary:
          type: string
          description: Summary period "monthly".
          example: monthly
      description: Payments Sub-Category
    TransactionDataAffordability:
      required:
      - account
      - amount
      - balance
      - class
      - description
      - direction
      - id
      - institution
      - links
      - postDate
      - status
      - transactionDate
      - type
      type: object
      properties:
        type:
          type: string
          description: Value is "transaction".
          example: transaction
        id:
          type: string
          description: Uniquely identifies the transaction.
          example: d3de1ca1
        account:
          type: string
          description: The id of the account resource the transaction belongs to.
          example: d3de1ca1
        amount:
          type: string
          description: Transaction amount. Outgoing funds are expressed as negative
            values.
          example: "123.12"
        balance:
          type: string
          description: Value of the account balance at time the transaction was completed.
          example: "123.12"
        class:
          type: string
          description: Describes the class(type) of transaction.
          example: payment
          enum:
          - bank-fee
          - payment
          - cash-withdrawal
          - transfer
          - loan-interest
          - refund
          - direct-cedit
          - interest
          - loan-repayment
        description:
          type: string
          description: The transaction description as submitted by the institution..
          example: DEBIT Only About Children Seaforth
        direction:
          type: string
          description: Identifies if the transaction is of debit or credit type.
          example: credit
          enum:
          - debit
          - credit
        institution:
          type: string
          description: The id of the institution resource the transaction originated
            from.
          example: AU00000
        postDate:
          type: string
          description: Date the transaction was posted as provided by the institution
            (this is the same date that appears on a bank statement). This value is
            null if the record is pending. e.g. "2017-11-10T21:46:44Z" or 2017-11-10T00:00:00Z.
          example: "2018-11-02T00:00:00Z"
        subClass:
          $ref: '#/components/schemas/subClassAffordability'
        status:
          type: string
          description: Identifies if a transaction is pending or posted. A pending
            transaction is an approved debit or credit transaction that has not been
            fully processed yet (i.e. has not been posted). Find out more about pending
            transaction and how to deal with them within your app. Note that pending
            transactions are not available for all institutions.
          example: pending
          enum:
          - pending
          - posted
        transactionDate:
          type: string
          description: Date that the user executed the transaction as provided by
            the institution. Note that not all transactions provide this value (varies
            by institution) e.g. "2017-11-10T00:00:00Z"
          example: "2018-11-02T00:00:00Z"
        links:
          $ref: '#/components/schemas/AffordabilityTransactionLinks'
  securitySchemes:
    services_token:
      type: http
      scheme: bearer
      bearerFormat: JWT
security:
  - services_token: []
x-readme:
  explorer-enabled: true
  proxy-enabled: true
  samples-enabled: true
  samples-languages:
    - curl
    - node
    - ruby
    - javascript
    - python