დოკუმენტაცია

Account Movement

Suggest Edits

Get account movements

This web service interface is used for obtaining account movements data from bank system based on provided filter parameter(s).
Since movements are very frequent business entities in banking environment, it is necessary to prevent long lasting remote requests started by client systems. A simple mechanism is implemented, where bank fills system parameter, which defines maximum number of returned movements in one response (pageSize700 entries in 1 response). Such message will also contain information whether all movements were returned or only part of them. This is done by paging objects. Client system is supposed to read paging metadata and send the same request but with different index number of required page. Downloading process of movements will end when client system downloads all pages.

📘

pageSize defines maximum number (700) of returned movements in one response.

to get next page of movements by date range request see example 11

Movement Attribute Formats

Attribute format defines allowed character set and maximal number of characters in the attribute value.
Exclamation mark (!) means that value should contain exactly the specified number of characters; e.g.:

  • '22!S' – value should contain exactly 22 characters that correspond to 'S' charset;
  • '22S' – value can contain up to 22 characters that correspond to 'S' charset;
  • '13n.2n' – digits and decimal point: up to 13 digits before point and up to 2 digits after the point.
Format CodeAllowed Charset
nDigits: 0123456789
ACapital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
SCapital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
Digits: 0123456789
Characters: / - ? : ( ) . , ` + _ * < > & SPACE
RGeorgian (Unicode, UTF-8) letters: აბგდევზთიკლმნოპჟრსტუფქღყშჩცძწჭხჯჰ
Lower case letters of the Latin alphabet: abcdefghijklmnopqrstuvwxyz
Capital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
Digits: 0123456789
Characters: / - ? : ( ) . , ' + space

🚧

Characters < > & must be represented as:

Characters must be represented: "<" as &lt; ">" as &gt; "&"as &amp;

List of request attributes in GetAccountMovements Web Service

AttributeTypeComment
accountNumberStringAccount number
accountCurrencyCodeStringAccount currency;
is mandatory when accountNumber is specified
periodFromDateTimePeriod interval “from” (inclusive)
periodToDateTimePeriod interval “to” (inclusive)
movementIdStringMovement ID
lastMovementTimestampDateTimesystem will return movements that have higher timestamp
(e.g. if 2013-10-25T15:23:12.000 is specified, then system will return movements that
were created or updated after that time)
pageIndexIntIndex of a movement page
pageSizeintNumber of transactions in one page (maximum 700 entries in 1 response)

List of response attributes in GetAccountMovements Web Service

AttributeTypeComment
movementIdStringMovement ID assigned by Banks NONDIGITAL channel(POS Terminal; PAYBOX; ATM; Cash operations)
paymentIdStringID of payment order based on which this movement was
generated (assigned by Banks's DIGITAL channel (Internet/Mobile banking; DBI integration service)
externalPaymentIdStringID of payment order based on which this movement was generated (assigned by Banks NONDIGITAL channel (POS Terminal; PAYBOX; ATM; Cash operations)
debitCreditIntegerOperation type: is debit or credit operation
0 = Debit
1 = Credit
valueDateDateTimeOperation date
DescriptionStringDescription
AmountMoneyIo (see catalog MoneyIo below)Amount and
currency of
movement
accountNumberStringAccount number
accountNameStringAccount name
additionalInformationStringAdditional information (recipient info)
documentDateDateTimeDocument date
documentNumberStringDocument number
partnerAccountNumberStringPartner's account number
partnerNameStringPartner's name
partnerTaxCodeStringPartner's tax code
partnerBankCodeStringPartner's bank code
partnerBankStringPartner's bank
intermediaryBankCodeStringIntermediary bank code
intermediaryBankStringIntermediary bank
chargeDetailString
3!A		Defines types of charges that can be used for SWIFT payments. it may have two values:
SHA - Beneficiary will receive amount reduced by intermediary bank’s fee
OUR - Beneficiary will receive full amount, you will pay additional 20USD/30EUR
taxpayerCodeStringTaxpayer code
taxpayerNameStringTaxpayer name
treasuryCodeStringTreasury code
operationCodeStringOperation code
additionalDescriptionStringAdditional description
exchangeRateStringExchange rate (for currency exchange operations)
partnerPersonalNumberStringPartner's personal number (for cash operations)
partnerDocumentTypeSee catalog
Identification
Document Type below		Partner's ID document type (for cash operations)
partnerDocumentNumberStringPartner's ID document number (for cash operations)
parentExternalPaymentIdStringPayment order ID of parent movement assigned by NONDIGITAL channel (POS Terminal; PAYBOX; ATM; Cash operations); e.g. this attribute can be filled for charge movements to link them with original payment movements
statusCodesee catalog Transaction Status belowAuthorization status code in NONDIGITAL channel (POS Terminal; PAYBOX; ATM; Cash operations) (Client system can guess that payment order is fully accepted and processed by Bank only after movement
gets Authorized status)
transactionTypesee catalog Transaction
Subtype below		Transaction type

Date formats

DateTime – in requests sent to Bank's Digital channel DateTime must be in format:
yyyy-MM-dd'T'HH:mm:ss.SSS e.g.: 2023-02-22T15:23:12.000
DateTime – in responses received from Bank's digital channel DateTime is in format:
yyyy-MM-dd'T'HH:mm:ssZ e.g.: 2023-02-22T00:00:00+04:00

Catalogs

MoneyIO

AttributeTypeComment
AmountDecimal
13n.2n		Numeric
representation of
amount
CurrencyString
3!A		Currency ISO code

Identification Document Type

Partner Document Type CodeDefinition
0Without passport
1Georgian citizen ID
2Georgian citizen passport
3Other countries citizen passport
4Permanent residence permit ID
5Soviet union passport
6Birth certificate
8Refugee ID
9IDP (Internally Displaced Person) Temporary Document
10Temporary ID for citizen of Georgia
11ID Card
12ID Card - residence permit ID
13Georgian living abroad ID
14Diplomatic card
15Neutral ID
16Neutral travel document
17Travel document
18Diplomatic passport for Georgian citizen
19Job passport for Georgian citizen
20Temporary ID card
21Unidentified
22ID Card - temporary residence permit electronic ID

Transaction Status

Transaction Status CodeDefinition
1Waiting for authorization
2Waiting for second authorization
3Authorized

Transaction Subtype

Transaction Subtype codeDefinition
1Transfer between own accounts
5Currency exchange
20Income
30Transfer out and cash withdrawal
31Bill, Top UP Mobile, fine payments
32Treasury transfers
33Other expenses

Filter combinations

There are several combinations of values which are considered as correct; the rest should return an error code: INCORRECT_INPUT_DATA.

Get Movement By ID

If movement ID parameter is filled, then other filtering parameters must be empty; if not then request will fail and an error code - INCORRECT_INPUT_DATA will be returned.

Example 1: Get Account Movement By ID Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:movementId>001157711468.1</myg:movementId>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 2: Get Account Movement By ID Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7777700000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test. კომპ</ns2:accountName>
				<ns2:additionalInformation>   ნინო სირაძე 00000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>22IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Get Account Movements By Last Movement Timestamp

If last movement timestamp is filled, then other filter parameters must be empty; if not then request will
fail and an error code - INCORRECT_INPUT_DATAwill be returned.

Example 3: Get Account Movement By lastMovementTimestamp Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:myg="http://www.mygemini.com/schemas/mygemini"
    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
    <soapenv:Header>
        <wsse:Security>
            <wsse:UsernameToken>
                <wsse:Username>USERNAME</wsse:Username>
                <wsse:Password>PASSWORD</wsse:Password>
                <wsse:Nonce>111111</wsse:Nonce>
            </wsse:UsernameToken>
        </wsse:Security>
    </soapenv:Header>
<soapenv:Body>
<myg:GetAccountMovementsRequestIo>
<myg:accountMovementFilterIo>
<myg:lastMovementTimestamp>2023-07-01T15:23:12.000</myg:lastMovementTimestamp>
</myg:accountMovementFilterIo>
</myg:GetAccountMovementsRequestIo>
</soapenv:Body>
</soapenv:Envelope>

Example 4: Get Account Movement By lastMovementTimestamp Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>0</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

📘

Get movements by other filtering parameters

All filter parameters can be filled except movement ID and last movement timestamp, otherwise the
request will fail and an error code - INCORRECT_INPUT_DATA will be returned.

❗️

Example 5: If Movement ID And/Or Last movement Timestamp Are Filled With Other Filter Parameters, Request Will Fail

MovementID Is Used With Other Filter Parameter In The Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:periodFrom>2023-07-01T15:23:12.000</myg:periodFrom>
				<myg:periodTo>2023-07-28T15:23:12.000</myg:periodTo>
				<myg:movementId>001157711468.1</myg:movementId>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Error response

<s:Envelope
	xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header/>
	<s:Body>
		<s:Fault>
			<faultcode
				xmlns:a="http://www.mygemini.com/schemas/mygemini">a:INCORRECT_INPUT_DATA
			</faultcode>
			<faultstring xml:lang="en">Incorrect combination of input data in filter.</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

Get Account Movements By Date Range

📘

Page Index

Response returns data block with paging information. Web Service automatically returns first page, which has index equal to zero (0). Since paging information in response contains total count and actual page size, calling system can easily count how many pages are needed to download all items matching the filter critera.
Calling system should send another request with page index equal to 1 to obtain the rest of the data (2nd page in example 11).

📘

Get movements by periodFrom - periodTo

  • If only periodFrom filter parameters is used, system will return movements that have higher timestamp (e.g. if 2023-10-25T15:23:12.000 is specified, then system will return movements that were created or updated after that time)
  • If only periodTo filter parameters is used, system will return movements that have lower timestamp (e.g. if 2023-10-25T15:23:12.000 is specified, then system will return movements that were created or updated beforethat time)
  • If both periodFrom and periodTo filter parameters is used (date range), system will return movements that have timestamp in between (e.g. if from date 2012-10-25T15:23:12.000 and to date
    2013-10-25T15:23:12.000 is specified, then system will return movements that were created or updated between date range)

Response returns data block with paging information. Web Service automatically returns first page, which has index equal to zero (0). Since paging information in response contains total count and actual page size, calling
system can easily count how many pages are needed to download all items matching the filter critera.

Example 5: Get Account Movement By periodFrom Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:periodFrom>2012-10-25T15:23:12.000</myg:periodFrom>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 6: Get Account Movement By periodFrom Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>0</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example 7: Get Account Movement By periodTo Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:periodTo>2023-10-25T15:23:12.000</myg:periodTo>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 8: Get Account Movement By periodTo Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>0</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Example 9: Get Account Movement By Date Range (First Page) Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:periodFrom>2012-10-25T15:23:12.000</myg:periodFrom>
				<myg:periodTo>2023-10-25T15:23:12.000</myg:periodTo>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 10: Get Account Movement By Date Range (First Page) Rsponse

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>0</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Get Next Page Of Movements By Date Range Request

Response returns data block with paging information. Web Service automatically returns first page, which has index equal to zero (0). Since paging information in response contains total count and actual page size, calling
system can easily count how many pages are needed to download all items matching the filter critera.
Calling system should send another request with page index equal to 1 to obtain the rest of the data (2nd page in this example).

Example 11: Get Next Page Of Movements By Date Range Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:pager>
					<myg:pageIndex>1</myg:pageIndex>
					<myg:pageSize>700</myg:pageSize>
          <!--Zero or more repetitions:-->
				</myg:pager>
				<myg:periodFrom>2012-10-25T15:23:12.000</myg:periodFrom>
				<myg:periodTo>2023-10-25T15:23:12.000</myg:periodTo>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 12: Get Next Page Of Movements By Date Range Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>1</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Get Account Movements By Account Number And Currency

📘

Account currency is mandatory when accountNumber is specified

can be used with date range and page index filters

Example 13: Get Account Movements By Account Number And Currency Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>111111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetAccountMovementsRequestIo>
			<myg:accountMovementFilterIo>
				<myg:pager>
					<myg:pageIndex>0</myg:pageIndex>
					<myg:pageSize>700</myg:pageSize>
				</myg:pager>
				<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
				<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				<myg:periodFrom>2012-10-25T15:23:12.000</myg:periodFrom>
				<myg:periodTo>2023-10-25T15:23:12.000</myg:periodTo>
			</myg:accountMovementFilterIo>
		</myg:GetAccountMovementsRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Example 14: Get Account Movements By Account Number And Currency Response

only specified account movements will be returned

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetAccountMovementsResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:result>
				<ns2:pager>
					<ns2:pageIndex>0</ns2:pageIndex>
					<ns2:pageSize>700</ns2:pageSize>
				</ns2:pager>
				<ns2:totalCount>38</ns2:totalCount>
			</ns2:result>
			<ns2:accountMovement>
				<ns2:movementId>011662735463.2</ns2:movementId>
				<ns2:externalPaymentId>11662735463</ns2:externalPaymentId>
				<ns2:debitCredit>1</ns2:debitCredit>
				<ns2:valueDate>2024-02-21T00:00:00</ns2:valueDate>
				<ns2:description>ანგარიშზე თანხის შეტანა</ns2:description>
				<ns2:amount>
					<ns2:amount>1234</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB00000000000</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>    test user პ/ნ  00000000000  </ns2:additionalInformation>
				<ns2:documentDate>2024-02-21T00:00:00</ns2:documentDate>
				<ns2:documentNumber>120045445</ns2:documentNumber>
				<ns2:partnerName>ნინო სირაძე</ns2:partnerName>
				<ns2:partnerTaxCode>00000000000</ns2:partnerTaxCode>
				<ns2:taxpayerCode>00000000000</ns2:taxpayerCode>
				<ns2:taxpayerName>ნინო სირაძე, 00000000000</ns2:taxpayerName>
				<ns2:operationCode>01</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerPersonalNumber>00000000000</ns2:partnerPersonalNumber>
				<ns2:partnerDocumentType>ID_CARD</ns2:partnerDocumentType>
				<ns2:partnerDocumentNumber>00IC00000</ns2:partnerDocumentNumber>
				<ns2:parentExternalPaymentId>0</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>20</ns2:transactionType>
			</ns2:accountMovement>
			<ns2:accountMovement>
				<ns2:movementId>010879982773.1</ns2:movementId>
				<ns2:externalPaymentId>10879982773</ns2:externalPaymentId>
				<ns2:debitCredit>0</ns2:debitCredit>
				<ns2:valueDate>2024-02-16T00:00:00</ns2:valueDate>
				<ns2:description>გადარიცხვის საკომისიო</ns2:description>
				<ns2:amount>
					<ns2:amount>1</ns2:amount>
					<ns2:currency>GEL</ns2:currency>
				</ns2:amount>
				<ns2:accountNumber>GE29TB7714836080100013</ns2:accountNumber>
				<ns2:accountName>შპს  test</ns2:accountName>
				<ns2:additionalInformation>საკომისიო შემოსავალი - იურიდიული პირების გადარიცხვები  GE49TB0006000000000000 </ns2:additionalInformation>
				<ns2:documentDate>2024-02-16T00:00:00</ns2:documentDate>
				<ns2:documentNumber>1708078553</ns2:documentNumber>
				<ns2:partnerAccountNumber>GE49TB0006001030220010</ns2:partnerAccountNumber>
				<ns2:taxpayerName>, </ns2:taxpayerName>
				<ns2:operationCode>GIT</ns2:operationCode>
				<ns2:exchangeRate/>
				<ns2:partnerDocumentType>WITHOUT_PASSPORT</ns2:partnerDocumentType>
				<ns2:parentExternalPaymentId>10879982772</ns2:parentExternalPaymentId>
				<ns2:statusCode>3</ns2:statusCode>
				<ns2:transactionType>33</ns2:transactionType>
			</ns2:accountMovement>
      --- --- --- ---
		</ns2:GetAccountMovementsResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Updated 8 months ago