--- title: "List the transactions of a VASP. The transactions are grouped by beneficiary and originator." method: GET path: "/tx/listBeneficiaryOriginator" tags: ["Transactions"] --- # List the transactions of a VASP. The transactions are grouped by beneficiary and originator. `GET /tx/listBeneficiaryOriginator` Fetches a list of transactions belonging to a VASP. The transactions will be grouped showing when the VASP is beneficiary and/or originator. ## Query parameters - `vaspDID` string, required — Decentralized Identifier ## Response `200` List of TransferInformation - TransactionsList - `transactions` TransactionResolved[] — List of Transaction - `id` string, uuid, required — Identifier of the Transfer - `status` 'SAVED' | 'MISSING_BENEFICIARY_DATA' | 'NEW' | 'WAITING_FOR_INFORMATION' | 'SENT' | 'REJECTED' | 'DECLINED' | 'ACK' | 'CANCELLED' | 'INCOMPLETE' | 'ACCEPTED' | 'NOT_READY' — Status of the Transfer * `SAVED` Transfer stored. * `MISSING_BENEFICIARY_DATA` TravelRule: Transfer Information is missing beneficiary data. * `NEW` TravelRule: Transfer Information was created, but not sent yet. * `WAITING_FOR_INFORMATION` TravelRule: Transfer Information is waiting for information to send. * `SENT` TravelRule: Transfer Information was sent (TRLight/TRP) * `REJECTED` TravelRule: Transfer rejected (TRP/Sygna) * `DECLINED` TravelRule: Transfer declined (TRP/Sygna) * `ACK` TravelRule: Destination blockchain address belongs to beneficiary confirmed. * `CANCELLED` Transfer cancelled. * `INCOMPLETE` Transfer created only with Blockchain Data (called by Beneficiary). * `ACCEPTED` Transfer accepted. * `NOT_READY` Transfer not ready. - `transactionType` 'BELOW_THRESHOLD' | 'NON_CUSTODIAL' | 'TRAVELRULE' | 'UNKNOWN', required — Type of the Transfer * `BELOW_THRESHOLD` Transfer is below all threshold. * `NON_CUSTODIAL` Transfer is on a customer owned wallet. Proof required. * `TRAVELRULE` Transfer is between VASPs. TravelRule transfer created. * `UNKNOWN` Transfer with any missing information. - `transactionAsset` string, required — Asset symbol (BTC,ETH) - `transactionAssetDecimals` number, required — Transaction Asset Decimals (eg BTC has 8 decimals) - `transactionAmount` string, required — Amount in base unit of the asset (satoshi, wei, etc) - `chargedQuantity` number, required — Charged Quantity - `amountInLocalCurrency` object — Amount in the local currency of the originator VASP's jurisdiction - `amountInLocalCurrency` number — Amount in the local currency of the originator VASP's jurisdiction - `currency` string — Currency code - `originatorDid` string — Decentralized Identifier - `originatorRef` string — Originator Customer Ref - `beneficiaryDid` string, required — Decentralized Identifier - `beneficiaryRef` string — Beneficiary Customer Ref - `originatorVASPdid` string — Decentralized Identifier - `beneficiaryVASPdid` string — Decentralized Identifier - `transactionBlockchainInfo` TransactionBlockchainInfo — Information about the transaction on the blockchain - `txHash` string — Transaction txHash - `origin` string — Originator Address - `destination` string, required — Destination Address - `ivms101` Ivms101IVMS101 - `originator` Ivms101Originator — The originator is defined in Section 1.1 as the account holder who allows the VA transfer from that account or, where there is no account, the natural or legal person that places the order with the originating VASP to perform the VA transfer. - `originatorPersons` Ivms101Person[], required — the account holder who allows the VA transfer from that account or, where there is no account, the natural or legal person that places the order with the originating VASP to perform the VA transfer. - `naturalPerson` NaturalPerson - `name` NaturalPersonName[], required — the distinct words used as identification for an individual - … - `geographicAddress` Ivms101Address[] — the particulars of a location at which a person may be communicated with. - … - `nationalIdentification` NationalIdentification - … - `customerIdentification` string — A character string - `dateAndPlaceOfBirth` DateAndPlaceOfBirth - … - `countryOfResidence` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `legalPerson` LegalPerson - `name` LegalPersonName, required - … - `geographicAddress` Ivms101Address[] - … - `customerNumber` string — A character string - `nationalIdentification` NationalIdentification - … - `dateOfRegistration` string — A point in time, represented as a day within the calendar year. Compliant with ISO 8601. (YYYY-MM-DD) - `countryOfRegistration` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `accountNumber` Text[] — Identifier of an account that is used to process the transfer. The value for this element is case-sensitive. - `beneficiary` Ivms101Beneficiary — The beneficiary is defined in Section 1.1 as the natural or legal person or legal arrangement who is identified by the originator as the receiver of the requested VA transfer. - `beneficiaryPersons` Ivms101Person[], required — the natural or legal person or legal arrangement who is identified by the originator as the receiver of the requested VA transfer. - `naturalPerson` NaturalPerson - `name` NaturalPersonName[], required — the distinct words used as identification for an individual - … - `geographicAddress` Ivms101Address[] — the particulars of a location at which a person may be communicated with. - … - `nationalIdentification` NationalIdentification - … - `customerIdentification` string — A character string - `dateAndPlaceOfBirth` DateAndPlaceOfBirth - … - `countryOfResidence` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `legalPerson` LegalPerson - `name` LegalPersonName, required - … - `geographicAddress` Ivms101Address[] - … - `customerNumber` string — A character string - `nationalIdentification` NationalIdentification - … - `dateOfRegistration` string — A point in time, represented as a day within the calendar year. Compliant with ISO 8601. (YYYY-MM-DD) - `countryOfRegistration` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `accountNumber` Text[] — Identifier of an account that is used to process the transfer. The value for this element is case-sensitive. - `originatingVASP` OriginatingVASP — The originating VASP is defined in Section 1.1 as the VASP which initiates the VA transfer, and transfers the VA upon receiving the request for a VA transfer on behalf of the originator. - `originatingVASP` Ivms101Person - `naturalPerson` NaturalPerson - `name` NaturalPersonName[], required — the distinct words used as identification for an individual - … - `geographicAddress` Ivms101Address[] — the particulars of a location at which a person may be communicated with. - … - `nationalIdentification` NationalIdentification - … - `customerIdentification` string — A character string - `dateAndPlaceOfBirth` DateAndPlaceOfBirth - … - `countryOfResidence` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `legalPerson` LegalPerson - `name` LegalPersonName, required - … - `geographicAddress` Ivms101Address[] - … - `customerNumber` string — A character string - `nationalIdentification` NationalIdentification - … - `dateOfRegistration` string — A point in time, represented as a day within the calendar year. Compliant with ISO 8601. (YYYY-MM-DD) - `countryOfRegistration` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `beneficiaryVASP` BeneficiaryVASP — The beneficiary is defined in Section 1.1 as the VASP which receives the transfer of a virtual asset from the originating VASP directly or through an intermediary VASP and makes the funds available to the beneficiary. - `beneficiaryVASP` Ivms101Person - `naturalPerson` NaturalPerson - `name` NaturalPersonName[], required — the distinct words used as identification for an individual - … - `geographicAddress` Ivms101Address[] — the particulars of a location at which a person may be communicated with. - … - `nationalIdentification` NationalIdentification - … - `customerIdentification` string — A character string - `dateAndPlaceOfBirth` DateAndPlaceOfBirth - … - `countryOfResidence` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `legalPerson` LegalPerson - `name` LegalPersonName, required - … - `geographicAddress` Ivms101Address[] - … - `customerNumber` string — A character string - `nationalIdentification` NationalIdentification - … - `dateOfRegistration` string — A point in time, represented as a day within the calendar year. Compliant with ISO 8601. (YYYY-MM-DD) - `countryOfRegistration` string — two alphabetic characters representing an ISO-3166 Alpha-2 country, including the code ‘XX’ to represent ‘an indicator for unknown States, other entities or organisations - `transferPath` TransferPath — The transfer path refers to the intermediary VASP(s) participating in a serial chain that receive(s) and retransmit(s) a VA transfer on behalf of the originating VASP and the beneficiary VASP, or another intermediary VASP, together with their corresponding sequence number. - `transferPath` IntermediaryVASP[] — the intermediary VASP(s) participating in a serial chain that receive and retransmit a VA transfer on behalf of the originating VASP and the beneficiary VASP, or another intermediary VASP, together with their corresponding sequence number. - `intermediaryVASP` Ivms101Person, required - `naturalPerson` NaturalPerson - … - `legalPerson` LegalPerson - … - `sequence` integer, required — Number represented as an integer (18 digits) - `payloadMetadata` PayloadMetadata — Data describing the contents of the payload. - `transliterationMethod` TransliterationMethodCode[] — the method used to map from a national system of writing to Latin script. - `ivms101Encrypted` string — Encrypted IVMS101 data - `protocol` 'TRLight' | 'TRP' | 'OpenVASP' - `protocolData` ProtocolData - `trLightData` object — TRLight Procotol data - `notificationEmails` string[] — Notification emails - `originatorProof` union — Ownership Proof, which can be an CryptographicalProof, ScreenshotProof, SelfDeclarationProof or MicroTransferProof - object — Attestation and its corresponding signed proof. - `type` 'eip-191' | 'eip-712' | 'bip-137', required — Type identifier for CryptographicalProof - `proof` string, required — Proof - `attestation` string, required — Attestation - `address` string — blockchain address - `status` string — Status of the proof - object — Screenshot Proof - `type` 'screenshot', required — Type identifier for ScreenshotProof, should be "screenshot" - `url` string, required — URL with the screenshot resource - object — Information about the self-declared proof. - `type` 'self-declaration', required — Type identifier for SelfDeclarationProof (should be self-declaration) - `did` string — customer identifier - `address` string — blockchain address - `attestation` string, required — The attestation - `confirmed` boolean — Whether the proof has been confirmed - `status` string — Status of the proof attestation - object — Information about the micro-transfer proof. - `type` 'microtransfer', required — Type identifier for MicroTransferProof (should be micro-transfer) - `did` string — did - `address` string — blockchain address being validated - `proof` string, required — hash of the micro-transfer proof - `chain` string — The chain of the micro-transfer, in CAIP format - `destination` string — Destination blockchain address - `amountSubunits` string — Amount of the microtransfer - `status` string — Status of the proof attestation - object — Other Proof - `type` string, required - `beneficiaryProof` union — Ownership Proof, which can be an CryptographicalProof, ScreenshotProof, SelfDeclarationProof or MicroTransferProof - object — Attestation and its corresponding signed proof. - `type` 'eip-191' | 'eip-712' | 'bip-137', required — Type identifier for CryptographicalProof - `proof` string, required — Proof - `attestation` string, required — Attestation - `address` string — blockchain address - `status` string — Status of the proof - object — Screenshot Proof - `type` 'screenshot', required — Type identifier for ScreenshotProof, should be "screenshot" - `url` string, required — URL with the screenshot resource - object — Information about the self-declared proof. - `type` 'self-declaration', required — Type identifier for SelfDeclarationProof (should be self-declaration) - `did` string — customer identifier - `address` string — blockchain address - `attestation` string, required — The attestation - `confirmed` boolean — Whether the proof has been confirmed - `status` string — Status of the proof attestation - object — Information about the micro-transfer proof. - `type` 'microtransfer', required — Type identifier for MicroTransferProof (should be micro-transfer) - `did` string — did - `address` string — blockchain address being validated - `proof` string, required — hash of the micro-transfer proof - `chain` string — The chain of the micro-transfer, in CAIP format - `destination` string — Destination blockchain address - `amountSubunits` string — Amount of the microtransfer - `status` string — Status of the proof attestation - object — Other Proof - `type` string, required - `actions` TransactionAction[] - `hash` string — Credential Hash - `issuerDID` string — Decentralized Identifier - `action` string — Action executed - `actionData` string — Action Data - `paginateInfo` PaginateInfo — Pagination information - `totalItems` integer - `itemCount` integer - `itemsPerPage` integer - `totalPages` integer - `currentPage` integer --- [API](https://skmtc.net/notabene/apis/notabene-api.md) · [All operations](https://skmtc.net/notabene/apis/notabene-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notabene/notabene-api/versions/70056745a433/schema)