Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Use /entity routing instead of /user

...

Endpoint ID:5004
Method:
Status
colourGreen
titleGET
URL:

/userentity/dp-keyid/{dpentity-keyid}/transactions/{transaction-group-id}?type={transaction-type-id}&from={from-date}&to={to-date}&limit={limit}&offset={offset}

/userentity/ext-key/{ext-key}/{ext-type}/transactions/{transaction-group-id}?type={transaction-type-id}&from={from-date}&to={to-date}&limit={limit}&offset={offset}


 dpentity-keydialogportal™ master key id

Rubiq entity ID that uniquely identifies the account to fetch transactions for

 


ext-key

External key that uniquely identifies the account to fetch transactions for

 


ext-type

Type of external key


 


Span
stylewhite-space: pre
transaction-group-id


Numeric value identifying the transaction group to search for. This ID is documented in the contract between dialogportal™ and the application


 transaction-type-idNumeric Optional numeric value identifying the transaction type to search for. This ID is documented in the contract between dialogportal™ and the application 

from-dateOptional date value limiting the search to only include transactions after this date. The date must be in UTC and formatted as "yyyymmddZ", for example "20140321Z" (21 March 2014).

 to-dateOptional date value limiting the search to only include transactions before this date. The date must be in UTC and formatted as "yyyymmddZ", for example "20140321Z" (21 March 2014). 

limitOptional maximum number of transactions to return. It is not possible to return more than 100 transactions per request, and if omitted, limit is set to 100 

offsetOptional offset in search results from where to return data. If omitted, offset is set to zero
Request body:None


Span
stylewhite-space:pre

Response body:


JSON data with an array transactions. The result will also contain an object with properties that specify number of transactions returned, the offset and whether there are more transactions than the ones returned.

Code Block
{
	"transactions": [
		{
        	"transactionID": 12478636,
        	"transactionGroupID": 12478636,
            "transactionGroupName": "SomeGroupName",
        	"transactionTypeID": 22,
            "transactionTypeName": "SomeTypeName",
        	"transactionDate": "2013-03-25T09:40:22.418Z",
        	"value": 1,
        	"reference": "RegisterSomeVoucherID"
        },
		{
        	"transactionID": 12478837,
        	"transactionGroupID": 12478636,
            "transactionGroupName": "SomeGroupName",
        	"transactionTypeID": 26,
            "transactionTypeName": "SomeOtherTypeName",
        	"transactionDate": "2013-09-14T11:01:15.902Z",
        	"value": 8.5,
        	"reference": "RegisterSomeVoucherID"
        }
	],
	"paging": {
		"offset": 0,
		"count": 2,
		"more": false
	}
}

 

 

 




Status codes:200

Transaction existence checked with success


 404

Account, transaction group or transaction type was not found, or no transactions were found.

The following sub codes may be returned:

404.1User not found
404.2External user could not be found
404.4Transaction group not found
404.5Transaction type not found
404.6No transactions found