Soldo Transactions API

openapi: 3.2.0
info:
  title: Soldo Business API v2.0 Transactions API
  description: Soldo Business API v2.0 OpenAPI specification
  version: 5.56.0
servers:
- url: https://api.soldo.com
  description: Production server (using live data)
- url: https://api-demo.soldocloud.net
  description: Sandbox server (using test data)
tags:
- name: Transactions
paths:
  /business/v2/transactions/mileage-reimbursements:
    post:
      tags:
      - Transactions
      summary: Create Mileage Reimbursement Transaction
      description: Endpoint to create a `MileageReimbursement` `Transaction`.
      operationId: mileage-reimbursement-transaction-create
      parameters:
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMileageReimbursementTransaction'
      responses:
        '200':
          description: The returned resource is a single `MileageReimbursement`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MileageReimbursementTransaction'
        '400':
          description: Your request has missing arguments or is malformed.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: request_timestamp, date, owner_id, mileage.vehicle_id, mileage.reimbursement_rate, mileage.distance, mileage.round_trip, token
  /business/v2/transactions/out-of-platform-transactions:
    post:
      tags:
      - Transactions
      summary: Create Out-Of-Platform Transaction
      description: Endpoint to create an Out-Of-Platform `Transaction` (not automatically tracked by Soldo).
      operationId: out-of-platform-transaction-create
      parameters:
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOutOfPlatformTransaction'
      responses:
        '200':
          description: The returned resource is a single Out-Of-Platform `Transaction`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutOfPlatformTransaction'
        '400':
          description: Your request has missing arguments or is malformed.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: request_timestamp, date, owner_id, merchant_name, tx_amount, tx_amount_currency, exchange_rate, payment_method, token
  /business/v2/transactions/mileage-reimbursements/{transactionId}:
    get:
      tags:
      - Transactions
      summary: Get Mileage Reimbursement Transaction
      description: Endpoint to get a specific `MileageReimbursement` `Transaction`.
      operationId: mileage-reimbursement-transaction-get
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '200':
          description: The returned resource is a single `MileageReimbursement`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MileageReimbursementTransaction'
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_read
      x-soldo:
        fingerprint-order: transactionId, token
    put:
      tags:
      - Transactions
      summary: Update Mileage Reimbursement Transaction
      description: Endpoint to update a `MileageReimbursement` `Transaction`. The entire resource representation must be included in the request body.
      operationId: mileage-reimbursement-transaction-update
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateMileageReimbursementTransaction'
      responses:
        '200':
          description: The returned resource is a single `MileageReimbursement`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MileageReimbursementTransaction'
        '400':
          description: Your request has missing arguments or is malformed.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: transactionId, request_timestamp, date, mileage.vehicle_id, mileage.reimbursement_rate, mileage.distance, mileage.round_trip, token
    delete:
      tags:
      - Transactions
      summary: Delete Mileage Reimbursement Transaction
      description: Endpoint to delete a specific `MileageReimbursement` `Transaction`.
      operationId: mileage-reimbursement-transaction-delete
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '204':
          description: No content as result.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: transactionId, token
  /business/v2/transactions/out-of-platform-transactions/{transactionId}:
    get:
      tags:
      - Transactions
      summary: Get Out-Of-Platform Transaction
      description: Endpoint to get a specific Out-Of-Platform `Transaction`.
      operationId: out-of-platform-transaction-get
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '200':
          description: The returned resource is a single Out-Of-Platform `Transaction`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutOfPlatformTransaction'
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_read
      x-soldo:
        fingerprint-order: transactionId, token
    put:
      tags:
      - Transactions
      summary: Update Out-Of-Platform Transaction
      description: Endpoint to update an Out-Of-Platform `Transaction`. The entire resource representation must be included in the request body.
      operationId: out-of-platform-transaction-update
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateOutOfPlatformTransaction'
      responses:
        '200':
          description: The returned resource is a single Out-Of-Platform `Transaction`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutOfPlatformTransaction'
        '400':
          description: Your request has missing arguments or is malformed.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: transactionId, request_timestamp, date, merchant_name, tx_amount, tx_amount_currency, exchange_rate, payment_method, token
    delete:
      tags:
      - Transactions
      summary: Delete Out-Of-Platform Transaction
      description: Endpoint to delete a specific Out-Of-Platform `Transaction`.
      operationId: out-of-platform-transaction-delete
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '204':
          description: No content as result.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: transactionId, token
  /business/v2/transactions/{transactionId}/tax-rate/{taxRateId}:
    post:
      tags:
      - Transactions
      summary: 'Add VAT Rate to Transaction '
      description: Endpoint to assign a `VatRate` to a `Transaction`.
      operationId: transaction-tax-rate-set
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: taxRateId
        in: path
        required: true
        schema:
          type: string
          description: The `VatRate` ID.
          example: 2d65bd5e-3fdf-4002-b166-bde7fb8863fa
      responses:
        '204':
          description: No content as result.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
  /business/v2/transactions/{transactionId}:
    get:
      tags:
      - Transactions
      summary: Get Transaction
      description: Endpoint to get a specific `Transaction` by ID.
      operationId: transaction-get
      parameters:
      - name: transactionId
        in: path
        description: The `Transaction` ID.
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
        example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: showDetails
        in: query
        description: It determines whether to show further Details of the `Transaction`.
        schema:
          type: boolean
          description: It determines whether to show further Details of the `Transaction`.
          example: false
        example: false
      - name: showFuelDetails
        in: query
        description: It determines whether to show further Fuel Details of the `Transaction`.
        schema:
          type: boolean
          description: It determines whether to show further Fuel Details of the `Transaction`.
          example: false
        example: false
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '200':
          description: The returned resource is a single `Transaction`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_read
      x-soldo:
        fingerprint-order: transactionId, token
    put:
      tags:
      - Transactions
      summary: Update Transaction
      description: Endpoint to update the assignee of a specific `Transaction` by ID. This method is only available for `Company` `Card` transactions and the `trx_owner_id` must be one of the `Card` assignees.
      operationId: transaction-update
      parameters:
      - name: transactionId
        in: path
        required: true
        schema:
          type: string
          description: The `Transaction` ID.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTransaction'
      responses:
        '200':
          description: The returned resource is a single `Transaction`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transaction'
        '400':
          description: Your request has missing arguments or is malformed.
        '404':
          description: One or more resource requested does not exist.
      security:
      - standardAuth:
        - transaction_write
      x-soldo:
        fingerprint-order: transactionId, userNotes, trxOwnerId, token
  /business/v2/transactions:
    get:
      tags:
      - Transactions
      summary: Search Transactions
      description: Endpoint to find `Transactions` using filtering parameters.
      operationId: transaction-search
      parameters:
      - name: type
        in: query
        description: The resource `type` to be used together with id.
        schema:
          $ref: '#/components/schemas/SearchTransactionResourceType'
        example: card
      - name: hasAttachment
        in: query
        description: Looks whether or not a `TransactionAttachment` is present.
        schema:
          type: boolean
          description: Looks whether or not a `TransactionAttachment` is present.
          example: true
        example: true
      - name: publicId
        in: query
        description: The ID of the `type` resource.
        schema:
          type: string
          description: The ID of the `type` resource.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
        example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: customreferenceId
        in: query
        description: The custom reference ID of the cardholder.
        schema:
          type: string
          description: The custom reference ID of the cardholder.
          example: 2d65bd5e-3fdf-4002-b166-bde7fb8863fa
        example: 2d65bd5e-3fdf-4002-b166-bde7fb8863fa
      - name: fromDate
        in: query
        description: 'The beginning of the period of the search `fromDate` included (i.e. greater than or equal to) (Formats: `yyyy-MM-dd`, `yyyy-MM-ddThh:mm:ss`, `yyyy-MM-ddThh:mm:ssZ`).'
        schema:
          $ref: '#/components/schemas/DateParam'
        example: '1970-01-30'
      - name: toDate
        in: query
        description: 'The end of the period of the search `toDate` included (i.e. less than) (Formats: `yyyy-MM-dd`, `yyyy-MM-ddThh:mm:ss`, `yyyy-MM-ddThh:mm:ssZ`).'
        schema:
          $ref: '#/components/schemas/DateParam'
        example: '1970-01-30'
      - name: dateType
        in: query
        description: It determines the date to be considered for `fromDate` and `toDate` parameters.
        schema:
          $ref: '#/components/schemas/SearchTransactionDateType'
        example: TRANSACTION
      - name: groupId
        in: query
        description: The ID of the `Group` of the transactions.
        schema:
          type: string
          description: The ID of the `Group` of the transactions.
          example: c861cc24-6663-410f-8c78-73f886fff4ef
        example: c861cc24-6663-410f-8c78-73f886fff4ef
      - name: category
        in: query
        description: It determines the filter by category of the transaction, multiple categories can be included.
        schema:
          type: array
          description: It determines the filter by category of the transaction, multiple categories can be included.
          items:
            $ref: '#/components/schemas/SearchTransactionCategory'
        example: Payment
      - name: status
        in: query
        description: It determines the filter by status of the transaction, multiple statuses can be included.
        schema:
          type: array
          description: It determines the filter by status of the transaction, multiple statuses can be included.
          items:
            $ref: '#/components/schemas/TransactionStatus'
        example: Authorised
      - name: paymentMethod
        in: query
        description: It determines the filter by payment method of the transaction, multiple payment methods can be included. `OUT_OF_PLATFORM_COMPANY` and `OUT_OF_PLATFORM_PERSONAL` are not included by default.
        schema:
          type: array
          description: It determines the filter by payment method of the transaction, multiple payment methods can be included. `OUT_OF_PLATFORM_COMPANY` and `OUT_OF_PLATFORM_PERSONAL` are not included by default.
          items:
            $ref: '#/components/schemas/SearchTransactionPaymentMethod'
          uniqueItems: true
        example: SUBSCRIPTION
      - name: tagId
        in: query
        description: The ID of the `Tag` of the transaction.
        schema:
          type: string
          description: The ID of the `Tag` of the transaction.
          example: 6853e657-c797-4985-8d6b-5425d4e51df8
        example: 6853e657-c797-4985-8d6b-5425d4e51df8
      - name: metadataId
        in: query
        description: The ID of the custom generated `Metadata` of the `Transaction`.
        deprecated: true
        schema:
          type: string
          deprecated: true
          description: The ID of the custom generated `Metadata` of the `Transaction`.
          example: express
        example: express
      - name: text
        in: query
        description: A simple text to search in the transaction data (merchant, merchant category, user notes, tag, list, masked pan, card name, tx amount, vehicle plate, vehicle description).
        schema:
          type: string
          description: A simple text to search in the transaction data (merchant, merchant category, user notes, tag, list, masked pan, card name, tx amount, vehicle plate, vehicle description).
          example: Amazon
        example: Amazon
      - name: expenseType
        in: query
        description: The type of the expense.
        schema:
          type: array
          description: The type of the expense.
          example: TRAVEL_AND_ENTERTAINMENT
          items:
            $ref: '#/components/schemas/ExpenseType'
        example: TRAVEL_AND_ENTERTAINMENT
      - name: expenseStatus
        in: query
        schema:
          type: array
          description: The status of the expense.
          example: APPROVED
          items:
            $ref: '#/components/schemas/ExpenseStatus'
      - name: expenseCategoryId
        in: query
        schema:
          type: array
          description: The ID of the Expense category of the transactions, multiple expense categories can be included.
          example: 2d65bd5e-3fdf-4002-b166-bde7fb8863fa
          items:
            type: string
            description: The ID of the Expense category of the transactions, multiple expense categories can be included.
            example: 2d65bd5e-3fdf-4002-b166-bde7fb8863fa
          uniqueItems: true
      - name: expenseReportId
        in: query
        schema:
          type: array
          description: The ID of the `ExpenseReport` of the transactions, multiple expense reports can be included.
          example: c861cc24-6663-410f-8c78-73f886fff4ef
          items:
            type: string
            description: The ID of the `ExpenseReport` of the transactions, multiple expense reports can be included.
            example: c861cc24-6663-410f-8c78-73f886fff4ef
      - name: exportStatus
        in: query
        description: The export status of the expense.
        schema:
          $ref: '#/components/schemas/ExportStatus'
        example: EXPORTED
      - name: taxRateId
        in: query
        schema:
          type: array
          description: The ID of the VAT rate of the transactions, multiple VAT rates can be included.
          example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
          items:
            type: string
            description: The ID of the VAT rate of the transactions, multiple VAT rates can be included.
            example: 7bf79328-a7ae-4222-aa54-091ff7f429a7
      - name: requiredInformation
        in: query
        description: To search transactions with (or without) required information. A transaction is `COMPLETE` when all details marked as mandatory in the `Reminders` section have been filled in for the transaction.
        schema:
          $ref: '#/components/schemas/SearchTransactionRequiredInformation'
        example: COMPLETE
      - name: isSplit
        in: query
        description: Looks whether or not a transaction is split.
        schema:
          type: boolean
          description: Looks whether or not a transaction is split.
          example: true
        example: true
      - name: customExportedProduct
        in: query
        description: A product that exported list of `Transaction`
        schema:
          type: string
          description: A product that exported list of `Transaction`
          example: SAP
        example: SAP
      - name: customExported
        in: query
        description: Looks whether or not a `TransactionCustomExport` is present.
        schema:
          type: boolean
          description: Looks whether or not a `TransactionCustomExport` is present.
          example: true
        example: true
      - name: p
        in: query
        description: It indicates the specific page to display (the counter starts from zero).
        schema:
          type: integer
          format: int32
          default: 0
          description: It indicates the specific page to display (the counter starts from zero).
          example: 3
        example: 3
      - name: s
        in: query
        description: It indicates the number of items per page.
        schema:
          type: integer
          format: int32
          default: 0
          description: It indicates the number of items per page.
          example: 25
          maximum: 50
        example: 25
      - name: d
        in: query
        description: It indicates how the pages are ordered.
        schema:
          $ref: '#/components/schemas/Direction'
        example: DESC
      - name: props
        in: query
        description: It indicates the sorting direction applied to the above parameters. To apply a sorting on multiple parameters, set as many times the `props` parameter in the request.
        schema:
          type: array
          description: It indicates the sorting direction applied to the above parameters. To apply a sorting on multiple parameters, set as many times the `props` parameter in the request.
          example: creationTime
          items:
            type: string
            description: It indicates the sorting direction applied to the above parameters. To apply a sorting on multiple parameters, set as many times the `props` parameter in the request.
            example: creationTime
        example: creationTime
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.'
          example: '{{fingerprint_signature}}'
      responses:
        '200':
          description: The result array contains `Transactions`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transactions'
        '400':
          description: Your request has missing arguments or is malformed.
      security:
      - standardAuth:
        - transaction_read
      x-soldo:
        fingerprint-order: type, publicId, customReferenceId, groupId, fromDate, toDate, dateType, category, status, tagId, metadataId, text, expenseType, expenseStatus, requiredInformation, token
webhooks:
  customer_care_withdraw:
    post:
      tags:
      - Transactions
      summary: Transaction - Customer Care Withdraw
      description: A `Withdrawal` has been performed by customer care support
      operationId: webhook-transaction-customer-care-withdraw
      parameters:
      - name: X-Soldo-Fingerprint
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint}}'
          description: '[Webhook authentication](ref:webhook-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this webhook.'
          example: '{{fingerprint}}'
      - name: X-Soldo-Fingerprint-Order
        in: header
        required: true
        schema:
          type: string
          default: id, walletId, status, transactionSign
          description: '[Webhook authentication](ref:webhook-authentication): The order of the values used to calculate the fingerprint.'
          example: id, walletId, status, transactionSign
      - name: X-Soldo-Fingerprint-Signature
        in: header
        required: true
        schema:
          type: string
          default: '{{fingerprint_signature}}'
          description: '[Webhook authentication](ref:webhook-authentication): Signature of the `X-Soldo-Fingerprint`. It must be verified using the [Soldo public key](ref:soldo-public-key).'
          example: '{{fingerprint_signature}}'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomerCareWithdrawEvent'
      responses:
        '200':
          description: Success.
      x-soldo:
        fingerprint-order: id, walle

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