Barclays Transactions API

openapi: 3.1.0
info:
  title: Transactions
  description: "Enable customers to view transactions, sorting and transaction-level details\n "
  version: '2.0'
x-method: searched
x-source: https://developer.barclays.com/api/apis/versions/5a31e498-f5c0-461e-b25a-9a0aed635bd6.bdn/design?specification=oas31
x-harvested: '2026-09-04'
x-harvested-note: Verbatim OpenAPI 3.1 design export from the Barclays API Exchange registry (developer.barclays.com), fetched
  anonymously. The untouched export is in openapi/_original/barclays-transactions-openapi.json. The UK Open Banking documents
  carry OBIE (openbanking.org.uk) in info.contact/termsOfService because they are the OBIE standard contract as Barclays implements
  and publishes it — the API, the registry record and the host are Barclays'.
tags:
- name: transactionsExternalAPI
  description: Transactions API
- name: postedTransactionAPI
  description: Posted transactions operations
- name: getAuthorizations
  description: Authorization transactions operations
- name: statementCycleDatesAPI
  description: Statement cycle dates operations
- name: searchOptionsAPI
  description: Transaction search options operations
paths:
  /{accountId}/statements/cycle-dates:
    summary: Get cycle dates for account id
    description: Get cycle dates for account id
    get:
      tags:
      - statementCycleDatesAPI
      summary: Get cycle dates for account id
      description: Get cycle dates for account id. Use this API to get account cycle dates.
      operationId: getCycleDatesV2
      parameters:
      - name: accountId
        in: path
        description: Account id
        required: true
        deprecated: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 2c4717c4-e2f3-4071-2b86-b86890873321
      - name: Correlation-ID
        in: header
        description: "Unique end-to-end trace ID. The initiating system (such as a Channel or \nBatch Job), must generate\
          \ this unique ID, then this must be passed \nthrough the API call stack. This is required to maintain compliance\
          \ with the current Barclays REST Standard."
        required: true
        deprecated: false
        allowEmptyValue: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 7d444840-9dc0-11d1-b245-5ffdce74fad2
      - name: Authorization
        in: header
        description: TIAA-US External token
        required: true
        deprecated: false
        schema:
          type: string
        example: Bearer <token>
      responses:
        '200':
          $ref: '#/components/responses/CycleDatesDataRes'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      deprecated: false
  /{accountId}/transactions/search-options:
    summary: Get transactions search options
    description: Get transactions search options
    get:
      tags:
      - searchOptionsAPI
      summary: Get transactions search options. This operation contains sensitive data in response payload.
      description: Get transactions search options. Use this API to get transactions search options.
      operationId: getSearchOptionsV2
      parameters:
      - name: accountId
        in: path
        description: Account id
        required: true
        deprecated: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 2c4717c4-e2f3-4071-2b86-b86890873321
      - name: Correlation-ID
        in: header
        description: "Unique end-to-end trace ID. The initiating system (such as a Channel or \nBatch Job), must generate\
          \ this unique ID, then this must be passed \nthrough the API call stack. This is required to maintain compliance\
          \ with the current Barclays REST Standard."
        required: true
        deprecated: false
        allowEmptyValue: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 7d444840-9dc0-11d1-b245-5ffdce74fad2
      - name: Authorization
        in: header
        description: TIAA-US External token
        required: true
        deprecated: false
        schema:
          type: string
        example: Bearer <token>
      responses:
        '200':
          $ref: '#/components/responses/SearchOptionsDataRes'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      deprecated: false
  /{accountId}/authorizations:
    summary: Get Auth transactions for Account ID
    description: Get Auth transactions for Account ID
    get:
      tags:
      - getAuthorizations
      summary: Get Auth transactions for Account ID
      description: 'This API provides a list of authorization for a given account for the given date range. These are transactions

        that are authorized but not yet posted to the account'
      operationId: getAuthorizationsExt
      parameters:
      - name: accountId
        in: path
        description: Account id
        required: true
        deprecated: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 2c4717c4-e2f3-4071-2b86-b86890873321
      - name: Correlation-ID
        in: header
        description: "Unique end-to-end trace ID. The initiating system (such as a Channel or \nBatch Job), must generate\
          \ this unique ID, then this must be passed \nthrough the API call stack. This is required to maintain compliance\
          \ with the current Barclays REST Standard."
        required: true
        deprecated: false
        allowEmptyValue: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 7d444840-9dc0-11d1-b245-5ffdce74fad2
      - name: Authorization
        in: header
        description: TIAA-US External token
        required: true
        deprecated: false
        schema:
          type: string
        example: Bearer <token>
      responses:
        '200':
          $ref: '#/components/responses/GetAuthorizationsExtRes'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      deprecated: false
  /{accountId}/transactions:
    summary: Get  transactions with timestamp for Account ID
    description: Get transactions with timestamp for Account ID
    get:
      tags:
      - postedTransactionAPI
      summary: Get transactions for Account ID. This operation contains sensitive data in response payload.
      description: Get transactions for Account ID. Use this API to get transaction.
      operationId: getTransactionsV2
      parameters:
      - name: accountId
        in: path
        description: Account id
        required: true
        deprecated: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 2c4717c4-e2f3-4071-2b86-b86890873321
      - name: fromDate
        in: query
        description: Start date for transactions yyyy-mm-dd
        schema:
          type: string
          format: date
          maxLength: 10
          minLength: 10
        example: '2012-03-22'
      - name: toDate
        in: query
        description: End date for transactions yyyy-mm-dd
        schema:
          type: string
          format: date
          maxLength: 10
          minLength: 10
        example: '2012-03-22'
      - name: statementDate
        in: query
        description: Transaction Date yyyy-mm-dd
        schema:
          type: string
          format: date
          maxLength: 10
          minLength: 10
        example: '2012-03-22'
      - name: requestType
        in: query
        description: Type of  Request to get transactions.
        schema:
          type: string
          enum:
          - BY_DATE_RANGE
          - BY_STATEMENT
          - SINCE_LAST_STATEMENT
        example: SINCE_LAST_STATEMENT
      - name: includeDispute
        in: query
        description: Boolean flag to include transactions in dispute
        schema:
          type: boolean
        example: true
      - name: purchasedByRef
        in: query
        description: Allowed data for purchased by customer id filter
        schema:
          type: string
          maxLength: 64
          minLength: 64
          pattern: ^[a-zA-Z0-9]{64}$
        example: a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e
      - name: category
        in: query
        description: Category options
        schema:
          type: string
          enum:
          - ALL
          - AUTOMOTIVE
          - EVERYDAY_SPENDING
          - HEALTHCARE
          - MERCHANDISE
          - RESTAURANTS_ENTERTAINMENT
          - TRAVEL
          - OTHER
        example: TRAVEL
      - name: keyword
        in: query
        description: Search keyword for filter
        schema:
          type: string
          maxLength: 256
          minLength: 1
          pattern: ^[a-zA-Z0-9]{1,256}$
        example: apple
      - name: Correlation-ID
        in: header
        description: "Unique end-to-end trace ID. The initiating system (such as a Channel or \nBatch Job), must generate\
          \ this unique ID, then this must be passed \nthrough the API call stack. This is required to maintain compliance\
          \ with the current Barclays REST Standard."
        required: true
        deprecated: false
        allowEmptyValue: false
        schema:
          type: string
          maxLength: 36
          minLength: 36
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
        example: 7d444840-9dc0-11d1-b245-5ffdce74fad2
      - name: Authorization
        in: header
        description: TIAA-US External token
        required: true
        deprecated: false
        schema:
          type: string
        example: Bearer <token>
      responses:
        '200':
          $ref: '#/components/responses/TransactionsDataResV2'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      deprecated: false
components:
  schemas:
    AuthorizationsList:
      type: object
      additionalProperties: false
      deprecated: false
      description: List of authorizations
      properties:
        authorizations:
          type: array
          items:
            $ref: '#/components/schemas/AuthorizationExt'
          maxItems: 500
          minItems: 0
      nullable: false
    AuthorizationsExtList:
      type: object
      additionalProperties: false
      deprecated: false
      description: List of authorizations
      properties:
        authorizations:
          type: array
          items:
            $ref: '#/components/schemas/AuthorizationExt'
          maxItems: 500
          minItems: 0
      nullable: false
    TransactionsDataV2:
      type: object
      additionalProperties: false
      deprecated: false
      description: transactions Response
      properties:
        data:
          $ref: '#/components/schemas/TransactionsListV2'
      nullable: false
    EasypayInfo:
      type: object
      deprecated: false
      description: Easy Pay installment plan information
      properties:
        status:
          type: string
          description: Easy Pay enrollment status
          example: ENROLLED
          maxLength: 20
          minLength: 1
          pattern: ^[A-Z_]+$
        installmentId:
          type: string
          description: Easy Pay installment plan identifier
          example: '1233333'
          maxLength: 64
          minLength: 1
          pattern: ^[a-zA-Z0-9\-]+$
      nullable: false
      x-class-extra-annotation: '@com.fasterxml.jackson.annotation.JsonInclude(com.fasterxml.jackson.annotation.JsonInclude.Include.NON_NULL)'
    Amount:
      type: object
      additionalProperties: false
      deprecated: false
      description: Payment Amount Object
      properties:
        amount:
          type: number
          deprecated: false
          description: It represents transaction amount
          example: 1234.56
          maximum: 99999999999.99
          minimum: 0
        currency:
          type: string
          deprecated: false
          description: Currency of payment amount
          enum:
          - USD
          example: USD
      required:
      - amount
      - currency
      nullable: false
    ErrorResponseType:
      type: object
      additionalProperties: false
      deprecated: false
      description: 'An API error response.

        '
      properties:
        meta:
          type: object
          additionalProperties: true
          description: Contains Non-standard meta information
        errors:
          type: array
          description: 'Contains one or more error messages and is mutually exclusive with the data item.

            This will not be returned in success scenarios.

            '
          items:
            $ref: '#/components/schemas/ErrorType'
          maxItems: 50
          minItems: 0
      nullable: false
    CycleDatesData:
      type: object
      additionalProperties: false
      deprecated: false
      description: cycle dates response
      properties:
        data:
          $ref: '#/components/schemas/CycleDatesList'
      nullable: false
    SearchOptions:
      type: object
      additionalProperties: false
      deprecated: false
      description: transactions search options
      properties:
        dateRange:
          type: array
          items:
            type: string
            format: date
            deprecated: false
            description: transaction from/to date
            example: '2021-08-17'
          maxItems: 2
          minItems: 2
        purchasedByOptions:
          type: array
          items:
            $ref: '#/components/schemas/PurchasedByOption'
          maxItems: 10
          minItems: 1
        isCategorySearchEnabled:
          type: boolean
          description: Indicator to check whether transaction search is enabled for cpc
          example: true
        categoryOptions:
          type: array
          description: Transaction category options
          example:
          - ALL
          - Automotive
          - Everyday spending
          - Healthcare
          - Merchandise
          - Restaurants & entertainment
          - Travel
          - Other
          items:
            type: string
            enum:
            - ALL
            - Automotive
            - Everyday spending
            - Healthcare
            - Merchandise
            - Restaurants & entertainment
            - Travel
            - Other
          maxItems: 8
          minItems: 8
      nullable: false
    PurchasedByOption:
      type: object
      additionalProperties: false
      deprecated: false
      description: transactions purchased by options
      properties:
        purchasedByRef:
          type: string
          deprecated: false
          description: Purchased customer reference id
          example: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9
          maxLength: 64
          minLength: 64
          pattern: ^[a-zA-Z0-9]{64}$
        firstName:
          $ref: '#/components/schemas/customerFirstOrLastName'
        lastName:
          $ref: '#/components/schemas/customerFirstOrLastName'
        roleType:
          type: string
          description: Customer role
          enum:
          - PRIMARY
          - AUTHORIZED
          - CO-APPLICANT
          - BUSINESS_OWNER
          - BUSINESS_EMPLOYEE
          - BUSINESS_ADMIN
          example: PRIMARY
        lastFour:
          type: string
          deprecated: false
          description: Customer account number last four
          example: '1234'
          maxLength: 4
          minLength: 4
          pattern: ^[0-9]{4}$
        activationDate:
          type: string
          format: date
          deprecated: false
          description: activation date
          example: '2021-08-30'
      nullable: false
    TransactionV2:
      type: object
      deprecated: false
      description: Transaction record
      properties:
        postingTime:
          type: integer
          deprecated: false
          description: Transaction posted timestamp
          example: 1234567
          maximum: 99999999
          minimum: 0
        classCode:
          type: string
          description: It represents type of purchase
          enum:
          - CA
          - PR
          - PY
          - FE
          - NIL
          example: PR
        postingDate:
          type: string
          format: date
          deprecated: false
          description: Transaction posting Date yyyy-mm-dd
          example: '2012-03-22'
        transactionDate:
          type: string
          format: date
          deprecated: false
          description: Date on which transaction occured yyyy-mm-dd
          example: '2012-03-22'
        category:
          type: string
          deprecated: false
          description: It represents transaction category
          example: TRAVEL
          maxLength: 255
          minLength: 1
          pattern: ^[a-zA-Z0-9 ]{1,255}$
        merchantName:
          type: string
          deprecated: false
          description: It represents merchant name
          example: 1800Flowers
          maxLength: 25
          minLength: 1
          pattern: ^[a-zA-Z0-9 '*@]{1,25}$
        merchantCity:
          type: string
          deprecated: false
          description: It represents merchant city
          example: New York
          maxLength: 13
          minLength: 1
          pattern: ^[a-zA-Z ]{1,13}$
        merchantState:
          type: string
          deprecated: false
          description: It represents merchant state
          example: NJ
          maxLength: 3
          minLength: 2
          pattern: ^[A-Z]{2,3}$
        merchantPostalCode:
          type: string
          deprecated: false
          description: It represents merchant postal code
          example: '0044'
          maxLength: 9
          minLength: 1
          pattern: ^[a-zA-Z0-9]{1,9}$
        merchantCountry:
          type: string
          deprecated: false
          description: It represents merchant country
          example: USA
          maxLength: 3
          minLength: 2
          pattern: ^[A-Z]{2,3}$
        merchantPhone:
          type: string
          deprecated: false
          description: It represents merchant phone
          example: 0227865487
          maxLength: 10
          minLength: 1
          pattern: ^[0-9]{1,10}$
        transactionType:
          type: string
          description: It represents transaction type
          enum:
          - DEBIT
          - CREDIT
          - NIL
          example: DEBIT
        transactionAmount:
          $ref: '#/components/schemas/Amount'
        transactionNumber:
          type: string
          deprecated: false
          description: It represents transactionNumber
          example: '1234567'
          maxLength: 23
          minLength: 1
          pattern: ^[a-zA-Z0-9]{1,23}$
        recurringPaymentIndicator:
          type: boolean
          description: Indicate whether transaction is reoccurring.
          example: false
        inDispute:
          type: boolean
          description: Indicator to check whether transaction is in Dispute
          example: false
        purchaserFirstName:
          $ref: '#/components/schemas/customerFirstOrLastName'
        purchaserLastName:
          $ref: '#/components/schemas/customerFirstOrLastName'
        purchaserNameSuffix:
          type: string
          deprecated: false
          description: It represents purchaserNameSuffix.
          example: Jr
          maxLength: 3
          minLength: 1
          pattern: ^[a-zA-Z]{1,3}$
        awardsEarned:
          type: number
          deprecated: false
          description: It represents awardsEarned
          example: 1234.0
          maximum: 99999999999.99
          minimum: 0
          multipleOf: 0.01
        transactionChannel:
          type: string
          description: Channel through which transaction was made
          enum:
          - ONLINE
          - IN_STORE
          - OTHER
          example: IN_STORE
        walletType:
          type: string
          description: Type of payment method/wallet used
          example: SAMSUNG_PAY
          maxLength: 100
          minLength: 1
          pattern: ^[a-zA-Z0-9_\- ]+$
        authCode:
          type: string
          description: Authorization code returned by the payment processor
          example: '123456'
          maxLength: 50
          minLength: 1
          pattern: ^[a-zA-Z0-9]+$
        authTimeStamp:
          type: string
          format: date-time
          description: Timestamp when authorization occurred (ISO 8601 format)
          example: '2026-01-11T20:29:49Z'
        easypayInfo:
          $ref: '#/components/schemas/EasypayInfo'
      nullable: false
    AuthorizationExt_authTransInfoExt:
      type: object
      deprecated: false
      description: Auth Trans Info
      properties:
        merchantName:
          type: string
          deprecated: false
          description: It represents merchant name
          example: 1800Flowers
          maxLength: 25
          minLength: 1
          pattern: ^[a-zA-Z0-9 '*@]{1,25}$
        dateAuth:
          type: string
          format: date
          deprecated: false
          description: It represents transaction Date
          example: '2012-03-22'
        authType:
          type: string
          description: Authorization Type which will hold values like PURCHASE/CASH/PAYMENT/...
          enum:
          - PURCHASE
          - CASH_NON_ATM
          - CASH_ATM
          - BALANCE_INQUIRY
          - MAIL_OR_PHONE_ORDER
          - MERCHANT_RETURN
          - PAYMENT
          - CHECK_GUARENTEE
          - CASH_BALANCE_TRANSFER
          - CONVENIENCE_CHECK
          - PURCHASE_BALANCE_TRANSFER
          - FAST_CASH
          - WITHHOLD_FROM_AVAILABLE
          - PIN_UNBLOCK
          - PIN_CHANGE
          - BANKCARD_DEPOSIT_ACCOUNT
          - FACP
          - BILL_PAYMENT
          - PIN_VERIFICATION
          - TRIAD_HOLD_PAY
          - PROBE_HOLD_PAY
          - ACCESS_FUNDS_TRANSFER
          - IBAN_AUTHORIZATION
          - MINI_STATEMENT
          - MOBILE_TOP_UP
          - ACCOUNT_VERIFICATION
          - TOKEN_ELIGIBILITY_REQUEST
          - TOKEN_PROVISION_REQUEST
          - TOKEN_AUTH_REQUEST
          - TOKEN_PROVISION_COMPLETED
          - TOKEN_LOCK_REQUEST
          - TOKEN_UNLOCK_REQUEST
          - TOKEN_DELETE_REQUEST
          - NIL
          example: TOKEN_LOCK_REQUEST
        amount:
          $ref: '#/components/schemas/Amount'
        resp:
          type: string
          description: Authorization Response whether it's approved or declined
          enum:
          - APPROVED
          - DECLINED
          - FRAUD
          - PICKUP
          - REFER
          - NIL
          example: REFER
        status:
          type: string
          description: It represents transaction status like MATCHED/ AMOUNT_INCLUDED /AMOUNT_NOT_INCLUDED/..
          enum:
          - MATCHED
          - AMOUNT_INCLUDED
          - AMOUNT_NOT_INCLUDED
          - REAL_TIME_AUTHORIZATION
          - REVERSED_AUTHORIZATION
          - PAY
          - NIL
          example: PAY
        authTimeStamp:
          type: string
          format: date-time
          description: Timestamp when authorization occurred
          example: '2026-01-16T12:05:21Z'
        authCode:
          type: string
          description: Authorization code returned by the payment processor
          example: '123456'
          maxLength: 50
          minLength: 1
          pattern: ^[0-9]+$
      nullable: false
    SearchOptionsData:
      type: object
      additionalProperties: false
      deprecated: false
      description: Transactions search options response
      properties:
        data:
          $ref: '#/components/schemas/SearchOptions'
      nullable: false
    AuthorizationExt:
      type: object
      deprecated: false
      description: Authorization record
      properties:
        authTransInfoExt:
          $ref: '#/components/schemas/AuthorizationExt_authTransInfoExt'
      nullable: false
    Authorization:
      type: object
      deprecated: false
      description: Authorization record
      properties:
        authTransInfo:
          $ref: '#/components/schemas/Authorization_authTransInfo'
      nullable: false
    TransactionsList:
      type: object
      additionalProperties: false
      deprecated: false
      description: transactions list
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionV2'
          maxItems: 500
          minItems: 0
      nullable: false
    AuthorizationsExtData:
      type: object
      additionalProperties: false
      deprecated: false
      description: Authorizations Response
      properties:
        data:
          $ref: '#/components/schemas/AuthorizationsExtList'
      nullable: false
    ErrorType:
      type: object
      additionalProperties: true
      description: Message details - additional operation execution information.
      properties:
        code:
          type: string
          description: Machine readable, unique code of the message related to particular case within operation execution.
          example: BAD_REQUEST
          maxLength: 100
          minLength: 1
          pattern: ^[a-zA-Z_]{1,100}$
        title:
          type: string
          description: Short description of the error. Not for displaying purposes.
          example: Bad Request
          maxLength: 250
          minLength: 1
          pattern: ^[a-zA-Z0-9\s"=,.']{1,255}$
        details:
          type: string
          description: Provides additional low-level details about the error to assist with troubleshooting.
          maxLength: 100
          minLength: 1
          pattern: ^[a-zA-Z0-9_]{1,255}$
        meta:
          type: object
          additionalProperties: true
          description: Object containing non-standard meta-information about the error.
      required:
      - code
      - details
      - title
    dateCycle:
      type: string
      format: date
      deprecated: false
      description: account cycle date
      example: '2021-08-17'
    CycleDatesList:
      type: object
      additionalProperties: false
      deprecated: false
      description: cycle dates list
      properties:
        cycleDates:
          type: array
          items:
            $ref: '#/components/schemas/dateCycle'
          maxItems: 24
          minItems: 0
      nullable: false
    Authorization_authTransInfo:
      type: object
      deprecated: false
      description: Auth Trans Info
      properties:
        merchantName:
          type: string
          deprecated: false
          description: It represents merchant name
          example: 1800Flowers
          maxLength: 25
          minLength: 1
          pattern: ^[a-zA-Z0-9 '*@]{1,25}$
        dateAuth:
          type: string
          format: date
          deprecated: false
          description: It represents transaction Date
          example: '2012-03-22'
        authType:
          type: string
          description: Authorization Type which will hold values like PURCHASE/CASH/PAYMENT/...
          enum:
          - PURCHASE
          - CASH_NON_ATM
          - CASH_ATM
          - BALANCE_INQUIRY
          - MAIL_OR_PHONE_ORDER
          - MERCHANT_RETURN
          - PAYMENT
          - CHECK_GUARENTEE
          - CASH_BALANCE_TRANSFER
          - CONVENIENCE_CHECK
          - PURCHASE_BALANCE_TRANSFER
          - FAST_CASH
          - WITHHOLD_FROM_AVAILABLE
          - PIN_UNBLOCK
          - PIN_CHANGE
          - BANKCARD_DEPOSIT_ACCOUNT
          - FACP
          - BILL_PAYMENT
          - PIN_VERIFICATION
          - TRIAD_HOLD_PAY
          - PROBE_HOLD_PAY
          - ACCESS_FUNDS_TRANSFER
          - IBAN_AUTHORIZATION
          - MINI_STATEMENT
          - MOBILE_TOP_UP
          - ACCOUNT_VERIFICATION
          - TOKEN_ELIGIBILITY_REQUEST
          - TOKEN_PROVISION_REQUEST
          - TOKEN_AUTH_REQUEST
          - TOKEN_PROVISION_COMPLETED
          - TOKEN_LOCK_REQUEST
          - TOKEN_UNLOCK_REQUEST
          - TOKEN_DELETE_REQUEST
          - NIL
          example: TOKEN_LOCK_REQUEST
        amount:
          $ref: '#/components/schemas/Amount'
        resp:
          type: string
          description: Authorization Response whether it's approved or declined
          enum:
          - APPROVED
          - DECLINED
          - FRAUD
          - PICKUP
          - REFER
          - NIL
          example: REFER
        status:
          type: string
          description: It represents transaction status like MATCHED/ AMOUNT_INCLUDED /AMOUNT_NOT_INCLUDED/..
          enum:
          - MATCHED
          - AMOUNT_INCLUDED
          - AMOUNT_NOT_INCLUDED
          - REAL_TIME_AUTHORIZATION
          - REVERSED_AUTHORIZATION
          - PAY
          - NIL
          example: PAY
      nullable: false
    customerFirstOrLastName:
      type: string
      deprecated: false
      description: Customer first or last name
      example: John
      maxLength: 30
      minLength: 1
      pattern: ^[a-zA-Z']{1,30}$
    TransactionsListV2:
      type: object
      additionalProperties: false
      deprecated: false
      description: transactions list
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionV2'
          maxItems: 500
          minItems: 0
      nullable: false
  responses:
    BadRequest:
      description: "The request could not be understood by the server due to malformed \nsyntax. The client SHOULD NOT repeat\
        \ the request without \nmodifications.\n"
      headers:
        Cache-Control:
          $ref: '#/components/headers/Cache-Control'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseType'
          examples:
            example-error-400:
              $ref: '#/components/examples/example-error-400-bad-request'
    CycleDatesDataRes:
      description: Account cycle dates history.
      headers:
        Cache-Control:
          $ref: '#/components/headers/Cache-Control'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CycleDatesData'
          examples:
            CycleDatesDataRes:
              $ref: '#/components/exampl

# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/barclays/refs/heads/main/openapi/barclays-transactions-openapi.yml