Mike.robski: 1 revision: Release 111

2015-09-18T17:10:35Z

1 revision: Release 111

Jerry.dimitrov: /* Request Headers */

2015-09-14T11:59:10Z

Request Headers

Mike.robski: 1 revision: Release 95

2014-07-02T05:58:01Z

1 revision: Release 95

Velimira.metodieva: /* Request Headers */

2014-06-13T14:29:45Z

Request Headers

Mike.robski: 1 revision: Release 93

2014-05-08T07:34:10Z

1 revision: Release 93

Angel.dinev: /* GET paginated transaction list call */

2014-04-11T11:15:43Z

GET paginated transaction list call

New page

= GET /accounts/''{accountId}''/transactions =
Retrieves a list of all account's transactions
__TOC__
== Request ==
<code>GET /accounts/''{accountId}''/transactions</code>

==== Parameters ====
; accountId - ''string''
: The Id of the account.

=== URI Parameters ===
None.

=== Request Headers ===
{{Authorization}}

== Response ==

=== Status Code ===
;200 OK
: Success

; 401 Unauthorized
: The supplied credentials are invalid or do not provide permissions for this operation.

;403 Forbidden
: The user lacks the necessary permissions to access the resource

;404 Not Found
: The account Id was not found.

=== Response Body ===
<nowiki>
{
{
"list": [{
"startDate": "{startDate}",
"endDate": "{endDate}",
"amount": {amount},
"description": "{description}",
"currency": "{currency}",
"date": "{date}",
"productSpecification": "",
"serviceNumber": "{serviceNumber}",
"type": "{type}",
"number": {number}
}],
"links" : [{
"href" : "https://api.hostway.com/accounts/{account_id}/transactions",
"rel" : "self"
}]
}
</nowiki>

==== Parameters ====
; list - ''list''
: A collection of dictionaries containing information about transactions

:; startDate - ''string''
:: Start date of transaction

:; endDate - ''string''
:: End date of transaction

:; ammount - ''integer''
:: Amount of transaction

:; description - ''string''
:: Description of transaction

:; currency - ''string''
:: Currency symbol of transaction

:; date - ''string''
:: Date of transaction

:; productSpecification - ''link''
:: URL link to the product specification

:; serviceNumber - ''string''
:: Service number info

:; type - ''string''
:: Type of transaction. Possible values are: 'charge', 'charge_back', 'payment', 'fee', 'refund', 'credit', 'cc_chargeback', 'charge_adjustment', 'discount', 'credit_adjustment', 'credit_proration', 'charge_proration', 'payment_adjustment', 'tax', 'cc_chargeback_reversal', 'usage_charge', 'write_off', 'undo_write_off', 'usage_discount'

:; number - ''int''
:: Transaction's number

:; links - ''list''
:: [[Hypermedia]] for the individual payment method

; links - ''list''
: [[Hypermedia]] for this resource. Links to self

== Examples ==

=== GET paginated transaction list call ===
'''Request'''

<nowiki>
GET {{APIBaseURL}}/accounts/test731993/transactions?page=1&pageSize=10
</nowiki>

'''Response'''
'''HTTP/1.1 200 OK'''
<nowiki>
{
"list" : [ {
"startDate": "2012-04-23",
"amount": 0.87,
"endDate": "2012-05-18",
"description": "Recurring fee Exchange 2010 Archiving, core.email.exchange2010.archiving 04/23/2012 through 05/18/2012",
"currency": "USD",
"date": "2012-04-23",
"productSpecification": "{{APIBaseURL}}/productSpecifications/test731993-00000137a32daee9e2b08715000a30fe33d32c",
"serviceNumber": "test731993-00000136dedf26dfd9ec22fd000a1ddba01da1",
"type": "charge",
"number": 101393524
}],
"links" : [
{
"href" : "{{APIBaseURL}}/accounts/test731993/transactions?page=1&pageSize=10",
"rel" : "self"
},
{
"href" : "{{APIBaseURL}}/accounts/test731993/transactions?page=2&pageSize=10",
"rel" : "next"
},
{
"href" : "{{APIBaseURL}}/accounts/test731993/transactions?page=44&pageSize=10",
"rel" : "last"
}]
}
</nowiki>

== See also ==
* [[Account|Account Management API]]
* [[Common Features]]

{{disqus}}
[[Category:Hostway API]]
[[Category:Account Management API]]