Finicity Payment Enablement Bundle API

Any or all of the Payments endpoints in one API call

Operations 2

GET /aggregation/v1/paysuite/customers/{customerId}/institutionLogins/{institutionLoginId}/accounts Fetch all the requested field details using institution login ID #
GET /aggregation/v1/paysuite/customers/{customerId}/accounts/{accountId} Fetch all the requested details using the account ID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/finicity-payment-enablement-bundle-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

finicity-payment-enablement-bundle-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Open Finance Payment Enablement Bundle API
  description: 'OpenAPI specification for Finicity APIs.


    Open Finance (formerly Open Banking) solutions in the US are provided by

    Finicity, a Mastercard company.'
  contact:
    name: API Support
    email: apisupport@mastercard.com
    url: https://developer.mastercard.com/open-finance-us/documentation/support/
  version: 1.43.0
servers:
- url: https://api.finicity.com
  description: Production
security:
- FinicityAppKey: []
  FinicityAppToken: []
tags:
- name: Payment Enablement Bundle
  description: Any or all of the Payments endpoints in one API call
paths:
  /aggregation/v1/paysuite/customers/{customerId}/institutionLogins/{institutionLoginId}/accounts:
    get:
      tags:
      - Payment Enablement Bundle
      description: 'This bundled API returns any or all of the Payments endpoints in one API call using institution login ID. This includes, Account Simple details, ACH details, Account Owner, and Account Balance. This requires initial setup to determine which endpoints are included in the API response.

        For Account Balance, You can define an additional query parameter `balance_cache_interval` to specify the time interval of the last cached balance.  This parameter is used by the server to determine whether the cached balance is still valid or if it needs to be refreshed.


        _Supported regions_: ![🇺🇸](https://flagcdn.com/20x15/us.png)'
      summary: Fetch all the requested field details using institution login ID
      operationId: GetAccountDetailsByInstitutionLoginId
      parameters:
      - $ref: '#/components/parameters/CustomerIdParameter'
      - $ref: '#/components/parameters/InstitutionLoginIdParameterPEB'
      - $ref: '#/components/parameters/IncludeParameter'
      - $ref: '#/components/parameters/PebAllowedBalanceCacheIntervalParameter'
      responses:
        '200':
          $ref: '#/components/responses/GetPaymentEnablementBundleResponse'
        '400':
          $ref: '#/components/responses/GetPaymentEnablementBundleBadRequestErrorResponse'
        '401':
          $ref: '#/components/responses/AuthenticationUnauthorizedErrorResponse'
        '404':
          $ref: '#/components/responses/GetPaymentEnablementBundleResourceNotFoundForInstitutionLoginIdErrorResponse'
  /aggregation/v1/paysuite/customers/{customerId}/accounts/{accountId}:
    get:
      tags:
      - Payment Enablement Bundle
      description: 'This bundled API will return any or all of the Payments endpoints in one API call using account ID. This includes, Account Simple details, ACH details, Account Owner, and Account Balance. This requires initial setup to determine which endpoints are included in the API response.

        For Account Balance, You can define an additional query parameter `balance_cache_interval` to specify the time interval of the last cached balance.  This parameter will be used by the server to determine whether the cached balance is still valid or if it needs to be refreshed.


        _Supported regions_: ![🇺🇸](https://flagcdn.com/20x15/us.png)'
      summary: Fetch all the requested details using the account ID
      operationId: GetAccountDetailsByAccountId
      parameters:
      - $ref: '#/components/parameters/CustomerIdParameter'
      - $ref: '#/components/parameters/AccountIdParameter'
      - $ref: '#/components/parameters/IncludeParameter'
      - $ref: '#/components/parameters/PebAllowedBalanceCacheIntervalParameter'
      responses:
        '200':
          $ref: '#/components/responses/GetPaymentEnablementBundleResponse'
        '400':
          $ref: '#/components/responses/GetPaymentEnablementBundleBadRequestErrorResponse'
        '401':
          $ref: '#/components/responses/AuthenticationUnauthorizedErrorResponse'
        '404':
          $ref: '#/components/responses/GetPaymentEnablementBundleResourceNotFoundForAccountIdErrorResponse'
components:
  examples:
    MissingFinicityAppKeyExample:
      value:
        code: '10026'
        message: Missing parameter (Finicity-App-Key)
    NoAccountForCustomerIdExample:
      value:
        code: 38003
        message: Customer does not have any accounts
    NotAuthorizedExample:
      value:
        code: '10021'
        message: You are not authorized.
    PaymentEnablementBundleResponseExample:
      value:
        customerId: '5000902316'
        errorCount: 0
        accountCount: 1
        accountIdentitySuccessCount: 1
        balanceDetailsSuccessCount: 1
        paymentInstructionSuccessCount: 1
        accounts:
        - id: '5011648377'
          institutionId: '4222'
          institutionName: FinBank
          institutionLoginId: 1007302745
          accountDetails:
            id: '5011648377'
            accountNumberDisplay: '8888'
            realAccountNumberLast4: '5678'
            name: Super Checking
            type: checking
            aggregationStatusCode: 0
            status: active
            aggregationSuccessDate: '2023-06-26T11:14:11Z'
            aggregationAttemptDate: '2023-06-26T11:14:11Z'
            createdDate: '2023-06-26T11:14:11Z'
            currency: USD
            displayPosition: 1
            authorizationStartDate: '2023-06-26T11:14:11Z'
            authorizationEndDate: '2023-07-26T11:14:11Z'
            authorizationExpires: true
            parentAccount: '5011648377'
          balanceDetails:
            id: 5011648377
            realAccountNumberLast4: '5678'
            availableBalance: 123.45
            availableBalanceDate: '2023-06-26T11:14:11Z'
            clearedBalance: 222.25
            clearedBalanceDate: '2023-06-26T11:14:11Z'
            aggregationStatusCode: 0
            currency: USD
          accountIdentity:
            holders:
            - relationship: AUTHORIZED_USER
              ownerName: John Smith, PhD
              firstName: John
              middleName: L
              lastName: Smith
              suffix: PhD
              nameClassification: home
              nameClassificationConfidenceScore: 100
              asOfDate: 1607450357
              addresses:
              - ownerAddress: 434 W Ascension Way
                type: Home
                line1: 434 W Ascension Way
                line2: 'Suite #200'
                line3: UT 84123
                city: Murray
                country: USA
                postalCode: '84123'
                state: UT
              emails:
              - isPrimary: true
                email: john@example.com
                emailType: Personal
              phones:
              - type: HOME
                country: '61'
                phone: 1-555-184-4200
              documentations:
              - taxId: 123-45-7890
                taxIdCountry: USA
                governmentId: '123456789'
          paymentInstruction:
            type: ach
            accountNumber: '124344454'
            tanEnabled: true
            descriptors:
            - type: routingNumber
              value: '2434345'
    NoAccountForInstitutionLoginIdExamplePEB:
      value:
        code: '38007'
        message: Customer does not have any accounts associated with institutionLoginId.
    CustomerNotFoundExample:
      value:
        code: '14001'
        message: Customer not found.
    GenericBadRequestExample:
      value:
        code: '14020'
        message: Bad request.
    InvalidCredentialsExample:
      value:
        code: '10001'
        message: Invalid credentials
    InvalidFieldParameterExample:
      value:
        code: 12019
        message: fields parameter value must be 'balanceDetails','paymentInstruction' and 'accountIdentity'
    PaymentEnablementBundleWithErrorResponseExample:
      value:
        customerId: '5000902316'
        errorCount: 2
        accountCount: 1
        accountIdentitySuccessCount: 0
        balanceDetailsSuccessCount: 0
        paymentInstructionSuccessCount: 1
        accounts:
        - id: '5011648377'
          institutionId: '4222'
          institutionName: TestBank
          institutionLoginId: 1007302745
          accountDetails:
            id: '5011648377'
            accountNumberDisplay: '8888'
            realAccountNumberLast4: '5678'
            name: Super Checking
            type: checking
            aggregationStatusCode: 0
            status: active
            aggregationSuccessDate: '2023-06-26T11:14:11Z'
            aggregationAttemptDate: '2023-06-26T11:14:11Z'
            createdDate: '2023-06-26T11:14:11'
            currency: USD
            displayPosition: 1
            authorizationStartDate: 1607450357
            authorizationEndDate: 1607459357
            authorizationExpires: true
            parentAccount: '5011648377'
          paymentInstruction:
            type: ach
            accountNumber: '124344454'
            tanEnabled: true
            descriptors:
            - type: routingNumber
              value: '2434345'
          errors:
          - fieldName: balanceDetails
            code: '102'
            description: FI Down for maintenance
          - fieldName: accountIdentity
            code: '102'
            description: FI Down for maintenance
  schemas:
    PaymentInstructionPEB:
      required:
      - accountNumber
      - type
      type: object
      properties:
        type:
          type: string
          description: Payment instruction type
          example: ach
        accountNumber:
          type: string
          description: The account number from the institution
          example: '124344454'
        tanEnabled:
          type: boolean
          description: This field indicates whether the FI uses a tokenized account number for origination purposes.
          example: true
        descriptors:
          type: array
          description: List of descriptors
          items:
            $ref: '#/components/schemas/Descriptor'
    IdentityRiskScore:
      type: number
      description: Comprehensive identity risk score with a higher score indicating a riskier account sign-up.
      example: 275
    AuthorizationExpires:
      type: boolean
      description: A Boolean flag that indicates whether the customer’s authorization period has a defined authorization end date.
      example: true
      default: false
    PhoneCountryCode:
      type: string
      description: The ISO-3166 alpha-2 country code associated with the phone number.
      example: UK
    ZipCode:
      type: string
      description: A ZIP code
      example: '84123'
    AccountOwnerDocumentation:
      description: Account owner documentation
      type: object
      properties:
        taxId:
          $ref: '#/components/schemas/TaxId'
        taxIdCountry:
          $ref: '#/components/schemas/Country'
        governmentId:
          $ref: '#/components/schemas/GovernmentId'
    PhoneLineType:
      type: string
      description: 'The line type of the phone number.

        * landline - traditional wired phone line.

        * fixed-voip - VoIP-based fixed line phones.

        * mobile - wireless phone line.

        * voicemail - voicemail-only service.

        * toll-free - callee pays for call.

        * premium - caller pays a premium for the call-e.g., 976 area code.

        * non-fixed-voip - Skype, for example * other - anything that does not match the previous categories.'
      example: mobile
    AccountOwnerHolders:
      required:
      - holders
      type: object
      properties:
        holders:
          type: array
          items:
            $ref: '#/components/schemas/AccountOwnerDetails'
          description: List of account owners
    EmailAddress:
      type: string
      description: An email address
      example: myname@mycompany.com
    AccountOwnerDocumentations:
      description: List of account owner documentation. Not currently available in the US region.
      type: array
      items:
        $ref: '#/components/schemas/AccountOwnerDocumentation'
    EmailDomainCreationDate:
      type: string
      description: Returns a date that the email domain was created.
      example: '2011-06-29T00:00:00.000Z'
    AccountOwnerPhones:
      description: List of phones
      type: array
      items:
        $ref: '#/components/schemas/AccountOwnerPhone'
    AddressLine2:
      type: string
      description: Address line 2
      example: 'Suite #200'
    AddressLine3:
      type: string
      description: Address line 3
      example: UT 84123
    IpGeolocationCountryCode:
      type: string
      description: The ISO-3166 alpha-2 country code associated with the geolocation of the IP address.
      example: US
    AddressLine1:
      type: string
      description: Address line 1
      example: 434 W Ascension Way
    AccountOwnerDetails:
      required:
      - ownerName
      - nameClassification
      - nameClassificationConfidenceScore
      type: object
      properties:
        relationship:
          $ref: '#/components/schemas/AccountOwnerRelationshipType'
        ownerName:
          $ref: '#/components/schemas/AccountOwnerName'
        firstName:
          $ref: '#/components/schemas/FirstName'
        middleName:
          $ref: '#/components/schemas/MiddleName'
        lastName:
          $ref: '#/components/schemas/LastName'
        suffix:
          $ref: '#/components/schemas/Suffix'
        nameClassification:
          $ref: '#/components/schemas/NameClassificationType'
        nameClassificationconfidencescore:
          $ref: '#/components/schemas/ClassificationConfidenceScore'
        asOfDate:
          $ref: '#/components/schemas/AsOfDate'
        addresses:
          $ref: '#/components/schemas/AccountOwnerAddresses'
        emails:
          $ref: '#/components/schemas/AccountOwnerEmails'
        phones:
          $ref: '#/components/schemas/AccountOwnerPhones'
        documentations:
          $ref: '#/components/schemas/AccountOwnerDocumentations'
        identityInsights:
          $ref: '#/components/schemas/AccountOwnerIdentityInsights'
      description: Owner of a customer account
    EmailIsDisposable:
      type: boolean
      description: True if the email address is from a disposable email service.
      example: true
    IdentityRiskReasonCode:
      type: string
      description: "Reason code for the identity risk score. Must be exactly two\n    uppercase letters."
      pattern: ^[A-Z]{2}$
      minLength: 2
      maxLength: 2
      example: AA
    PhoneCountry:
      type: string
      description: Country calling code of the phone number as defined by ITU-T E.123 and E.164 international standards (max length 3)".
      example: '61'
    Alerts:
      type: string
      description: An alert generated when processing the request.
      example: Unable to generate IP and user insights
    MiddleName:
      type: string
      description: The middle name of the account holder
      example: L
    PhoneNumber:
      type: string
      description: A phone number (max length 15).
      example: 1-801-984-4200
    ErrorMessage:
      required:
      - code
      type: object
      properties:
        code:
          type: object
          description: 'An error code (can be returned as a number or a string). Useful links: [Common API Status Codes](https://developer.mastercard.com/open-finance-us/documentation/errors/best-practices/#common-api-status-codes), [Aggregation Status Codes](https://developer.mastercard.com/open-finance-us/documentation/products/manage/account-aggregation/#aggregation-status-codes).'
          example: '10001'
        status:
          type: string
          description: A status code
          example: '401'
        title:
          type: string
          description: A title for the error
          example: Connecting accounts error
        level:
          type: string
          description: An error level
          example: error
        message:
          type: string
          description: An error message
          example: Invalid authorization credentials
        user_message:
          type: string
          description: Some more details about the error
          example: The session has expired or is invalid
        assetId:
          $ref: '#/components/schemas/AssetId'
        accountId:
          $ref: '#/components/schemas/AccountId'
        externalTransactionId:
          type: string
          description: A unique identifier for the transaction that assists in linking data back to your systems.
          example: MAC1005061234
          minLength: 1
          maxLength: 100
        tags:
          type: string
          description: Categories that the error belongs to
          example: AGG
    DeviceBrowser:
      type: string
      description: The name of the browser used to authorize your product or service.
      example: Safari
    AccountId:
      type: string
      description: An account ID
      example: '5011648377'
    AccountOwnerAddress:
      description: Account owner address
      type: object
      properties:
        ownerAddress:
          $ref: '#/components/schemas/Address'
        type:
          $ref: '#/components/schemas/AddressType'
        line1:
          $ref: '#/components/schemas/AddressLine1'
        line2:
          $ref: '#/components/schemas/AddressLine2'
        line3:
          $ref: '#/components/schemas/AddressLine3'
        city:
          $ref: '#/components/schemas/City'
        state:
          $ref: '#/components/schemas/State'
        postalCode:
          $ref: '#/components/schemas/ZipCode'
        country:
          $ref: '#/components/schemas/Country'
    AccountIdentitySuccessCount:
      type: integer
      format: int32
      description: Total number of successful sections returned when requesting accountIdentity. If not provided, value will be 0.
      example: 1
    NameClassificationType:
      type: string
      description: 'The classification of the account holder:

        * "person / personal / home"

        * "business"

        * "other"'
      example: person
    IpLastSeenDays:
      type: number
      description: Count of days since the IP address was last observed in Ekata's Identity Network. If the IP address has not been observed before, IpLastSeenDays will be 0.
      example: 15
    IpPhoneDistance:
      type: number
      description: The distance (in miles) between the IP address and the closest physical address associated with the phone number.
      example: 200
    AccountOwnerEmails:
      description: List of emails
      type: array
      items:
        $ref: '#/components/schemas/AccountOwnerEmail'
    IpAddressDistance:
      type: number
      description: The distance (in miles) between the IP address and the physical address.
      example: 210
    PaymentInstructionSuccessCount:
      type: integer
      format: int32
      description: Total number of successful sections returned when requesting paymentInstruction. If not provided, value will be 0.
      example: 1
    Descriptor:
      required:
      - type
      - value
      type: object
      properties:
        type:
          type: string
          description: Payment Instruction Descriptor Type
          example: routingNumber
        value:
          type: string
          description: Value that the Descriptor Type Holds
          example: '2434345'
    EmailValid:
      type: boolean
      description: True if the email address is valid.
      example: true
    AggregationStatus:
      type: string
      description: "\"pending\" during account discovery, always \"active\" following\n  successful account activation"
      example: active
    PhoneLastSeenDays:
      type: number
      description: Count of days since the phone was last observed in Ekata's Identity Network. If the phone has not been observed before, `phoneLastSeenDays` will be 0.
      example: 42
    PaymentEnablementBundle:
      required:
      - errorCount
      - customerId
      - accounts
      type: object
      properties:
        customerId:
          $ref: '#/components/schemas/CustomerId'
        errorCount:
          $ref: '#/components/schemas/ErrorCount'
        accountCount:
          $ref: '#/components/schemas/AccountCount'
        accountIdentitySuccessCount:
          $ref: '#/components/schemas/AccountIdentitySuccessCount'
        balanceDetailsSuccessCount:
          $ref: '#/components/schemas/BalanceDetailsSuccessCount'
        paymentInstructionSuccessCount:
          $ref: '#/components/schemas/PaymentInstructionSuccessCount'
        accounts:
          type: array
          description: List of Account Details
          items:
            $ref: '#/components/schemas/PEBAccountDetails'
    LastName:
      type: string
      description: The last name of the account holder
      example: Smith
    AccountSimpleDetails:
      required:
      - accountNumberDisplay
      - createdDate
      - currency
      - name
      - status
      - type
      type: object
      properties:
        id:
          $ref: '#/components/schemas/AccountId'
        accountNumberDisplay:
          $ref: '#/components/schemas/AccountNumberDisplay'
        name:
          $ref: '#/components/schemas/Name'
        type:
          $ref: '#/components/schemas/AccountType'
        aggregationStatusCode:
          $ref: '#/components/schemas/AggregationStatusCode'
        status:
          $ref: '#/components/schemas/AggregationStatus'
        aggregationSuccessDate:
          $ref: '#/components/schemas/DateTimeWithZone'
        aggregationAttemptDate:
          $ref: '#/components/schemas/DateTimeWithZone'
        createdDate:
          $ref: '#/components/schemas/DateTimeWithZone'
        currency:
          $ref: '#/components/schemas/Currency'
        displayPosition:
          $ref: '#/components/schemas/DisplayPosition'
        authorizationStartDate:
          $ref: '#/components/schemas/AuthorizationStartDate'
        authorizationEndDate:
          $ref: '#/components/schemas/AuthorizationEndDate'
        authorizationExpires:
          $ref: '#/components/schemas/AuthorizationExpires'
        parentAccount:
          $ref: '#/components/schemas/AccountId'
    AvailableBalancePEB:
      required:
      - realAccountNumberLast4
      - availableBalance
      - availableBalanceDate
      - clearedBalance
      - clearedBalanceDate
      - aggregationStatusCode
      - currency
      type: object
      properties:
        id:
          $ref: '#/components/schemas/NumericAccountId'
        realAccountNumberLast4:
          $ref: '#/components/schemas/AccountNumberLast4'
        availableBalance:
          type: number
          description: The available balance of the account
          format: double
          example: 123.45
          minimum: 0
          maximum: 10000000000000000
        availableBalanceDate:
          $ref: '#/components/schemas/DateTimeWithZone'
        clearedBalance:
          type: number
          description: The cleared balance of the account. Also referred as posted balance, current balance, ledger balance
          example: 222.25
          format: double
          minimum: 0
          maximum: 9999999999999
        clearedBalanceDate:
          $ref: '#/components/schemas/DateTimeWithZone'
        aggregationStatusCode:
          $ref: '#/components/schemas/AggregationStatusCode'
        currency:
          $ref: '#/components/schemas/Currency'
    AccountType:
      type: string
      description: 'The list of supported account types.

        * "checking": Standard checking

        * "savings": Standard savings

        * "cd": Certificates of deposit

        * "moneyMarket": Money Market

        * "creditCard": Standard credit cards

        * "lineOfCredit": Home equity, line of credit

        * "investment": Generic investment (no details)

        * "investmentTaxDeferred": Generic tax-advantaged investment (no details)

        * "employeeStockPurchasePlan": ESPP, Employee Stock Ownership Plans (ESOP), Stock Purchase Plans

        * "ira": Individual Retirement Account (not Rollover or Roth)

        * "401k": 401K Plan

        * "roth": Roth IRA, Roth 401K

        * "403b": 403B Plan

        * "529plan": 529 Plan (True value is 529)

        * "rollover": Rollover IRA

        * "ugma": Uniform Gifts to Minors Act

        * "utma": Uniform Transfers to Minors Act

        * "keogh": Keogh Plan

        * "457plan": 457 Plan (True value is 457)

        * "401a": 401A Plan

        * "brokerageAccount": Brokerage Account

        * "educationSavings": Education Savings Account that is not a 529

        * "healthSavingsAccount": HSA (Health Savings Accounts)

        * "pension": Pension

        * "profitSharingPlan": Profit Sharing Plan

        * "roth401k": Roth 401K

        * "sepIRA": Simplified Employee Pension IRA

        * "simpleIRA": Simple IRA

        * "thriftSavingsPlan": Thrift Savings Plan

        * "variableAnnuity": Variable Annuity

        * "cryptocurrency": Cryptocurrency Wallet, Cryptocurrency Account

        * "mortgage": Standard Mortgages

        * "loan": Auto loans, equity loans, other loans

        * "studentLoan": Student Loan

        * "studentLoanGroup": Student Loan Group

        * "studentLoanAccount": Student Loan Account'
      example: checking
    EmailFirstSeenDays:
      type: number
      description: Count of days since the email was first observed in Ekata's Identity Network. If the email has not been observed before, first_seen_days will be 0.
      example: 453
    AccountOwnerAddresses:
      description: List of addresses
      type: array
      items:
        $ref: '#/components/schemas/AccountOwnerAddress'
    PhoneCarrier:
      type: string
      description: The company that provides voice and/or data services for the phone number. Carriers are returned at the MVNO level.
      example: Vodafone UK ltd.
    AccountOwnerIdentityInsights:
      description: List of account owner Identity Insights
      type: object
      properties:
        requestRefId:
          $ref: '#/components/schemas/RequestRefId'
        isEmailValid:
          $ref: '#/components/schemas/EmailValid'
        emailFirstSeenDays:
          $ref: '#/components/schemas/EmailFirstSeenDays'
        emailDomainCreationDate:
          $ref: '#/components/schemas/EmailDomainCreationDate'
        emailToName:
          $ref: '#/components/schemas/EmailToName'
        emailMailboxVelocity:
          $ref: '#/components/schemas/EmailMailboxVelocity'
        emailIsDisposable:
          $ref: '#/components/schemas/EmailIsDisposable'
        ipRisk:
          $ref: '#/components/schemas/IpRisk'
        ipRiskScore:
          $ref: '#/components/schemas/IpRiskScore'
        identityRiskReasonCode:
          $ref: '#/components/schemas/IdentityRiskReasonCode'
        deviceRiskScore:
          $ref: '#/components/schemas/DeviceRiskScore'
        deviceType:
          $ref: '#/components/schemas/DeviceType'
        deviceBrowser:
          $ref: '#/components/schemas/DeviceBrowser'
        devicePlatform:
          $ref: '#/components/schemas/DevicePlatform'
        devicePhoneEmailFirstSeen:
          $ref: '#/components/schemas/DevicePhoneEmailFirstSeen'
        deviceBrowserIpTzDifference:
          $ref: '#/components/schemas/DeviceBrowserIpTzDifference'
        deviceIpEmailFirstSeen:
          $ref: '#/components/schemas/DeviceIpEmailFirstSeen'
        ipLastSeenDays:
          $ref: '#/components/schemas/IpLastSeenDays'
        ipGeolocationCountryCode:
          $ref: '#/components/schemas/IpGeolocationCountryCode'
        ipGeolocationSubdivision:
          $ref: '#/components/schemas/IpGeolocationSubdivision'
        ipPhoneDistance:
          $ref: '#/components/schemas/IpPhoneDistance'
        ipAddressDistance:
          $ref: '#/components/schemas/IpAddressDistance'
        isPhoneValid:
          $ref: '#/components/schemas/PhoneValid'
        phoneLineType:
          $ref: '#/components/schemas/PhoneLineType'
        phoneCarrier:
          $ref: '#/components/schemas/PhoneCarrier'
        phoneCountryCode:
          $ref: '#/components/schemas/PhoneCountryCode'
        phoneLastSeenDays:
          $ref: '#/components/schemas/PhoneLastSeenDays'
        phoneEmailFirstSeenDays:
          $ref: '#/components/schemas/PhoneEmailFirstSeenDays'
        phoneToName:
          $ref: '#/components/schemas/PhoneToName'
        phoneToAddress:
          $ref: '#/components/schemas/PhoneToAddress'
        addressValidityLevel:
          $ref: '#/components/schemas/AddressValidityLevel'
        addressToName:
          $ref: '#/components/schemas/AddressToName'
        emailRisk:
          $ref: '#/components/schemas/EmailRisk'
        identityRiskScore:
          $ref: '#/components/schemas/IdentityRiskScore'
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/Warnings'
        alerts:
          type: array
          items:
            $ref: '#/components/schemas/Alerts'
    PhoneToAddress:
      type: string
      description: 'The match status between the input phone and the queried entity.

        * match - Phone location matches input address line 1, address line 2, city, state, and postal code.


        * postal-match - Phone location postal code matches input address postal code.


        * zip4-match - Phone location postal code zip+4 matches input address postal code zip+4.


        * city-state-match - Phone location city and state matches input address city and state.

        * metro-match - Phone location is in the same metro area as input address.


        * country-match - Phone location country matches input address country.


        * no-match - Phone location does not match input address.'
      example: match
    DeviceBrowserIpTzDifference:
      type: integer
      description: Time zone difference between device browser and IP location
      example: 1000
    AddressType:
      type: string
      description: 'The type of address location:

        * "Business"

        * "Home"

        * "Mailing"'
      example: Home
    AuthorizationEndDate:
      type: integer
      format: int64
      description: Authorization end date and time in epoch format (not used if AuthorizationExpires is false).
      example: 1641030399
    AccountOwnerEmailPrimary:
      type: boolean
      description: The email is primary.
      example: true
    InstitutionName:
      type: string
      description: The name of the institution
      example: FinBank
    DeviceType:
      type: string
      description: The device type used to authorize your product or service.
      example: iPhone
    PhoneToName:
      type: string
      description: 'The match status between the input name and the queried entity.


        * not-found


        * match


        * no-match'
      example: match
    Country:
      type: string
      description: Country code is Iso3166-1 Alpha-2 code and Alpha 3 standard (max length 3).
      example: CAN
    Fields:
      type: string
      description: Mention API fields that needs to be fetched
      example: balanceDetails,paymentInstruction,accountIdentity
    PhoneValid:
      type: boolean
      description: True if the phone number is valid.
      example: true
    FieldErrors:
      type: array
      description: Lists of errors while getting the data
      items:
        $ref: '#/components/schemas/FieldError'
    AccountOwnerRelationshipType:
      type: string
      description: 'The type of relationship to the account:

        * "AUTHORIZED_USER"


        * "BUSINESS"


        * "FOR_BENEFIT_OF_PRIMARY"


        * "FOR_BENEFIT_OF_PRIMARY_JOINT_RESTRICTED"


        * "FOR_BENEFIT_OF_SECONDARY"


        * "FOR_BENEFIT_OF_SECONDARY_JOINT_RESTRICTED"


        * "FOR_BENEFIT_OF_SOLE_OWNER_RESTRICTED"


        * "POWER_OF_ATTORNEY"


        * "PRIMARY_JOINT_TENANTS"


        * "PRIMARY"


        * "PRIMARY_BORROWER"


        * "PRIMARY_JOINT"


        * "SECONDARY"


        * "SECONDARY_JOINT_TENANTS"


        * "SECONDARY_BORROWER"


        * "SECONDARY_JOINT"


        * "SOLE_OWNER"


        * "TRUSTEE"


        * "UNIFORM_TRANSFER_TO_MINOR"'
      example: AUTHORIZED_USER
    AddressToName:
      type: string
      description: 'The match status between the input name and the queried entity.

        * not-found

        * match

        * no-match'
      example: match
    InstitutionId:
      description: The ID of a financial institution
      type: string
      example: '4222'
    Address:
      type: string
      description: A street address
      example: '434 W Ascension Way Suite #200 Murray UT 84123'
    AccountOwnerPhone

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/finicity/refs/heads/main/openapi/finicity-payment-enablement-bundle-api-openapi.yml