# View transfer history

Retrieve the transfer history of the specified account.

Endpoint: GET /accounts/{number}/transfers
Version: 3.0.0
Security: SessionKey

## Path parameters:

  - `number` (string, required)
    Alphanumeric identifier of the user account

## Query parameters:

  - `records` (integer)
    The number of records per page that should be returned

  - `page` (integer)
    The number of the results page to return

  - `role` (string, required)
    Determines whether to return transfers for which the account holder is the sender or the recipient
    Enum: "sender", "recipient"

  - `status` (string)
    If set, only returns transfers currently in the specified status
    Enum: "Pending", "Claimed", "Cancelled"

## Response 200 fields (application/json):

  - `total` (integer)
    The total number of results available

  - `page` (integer)
    The number of the results page returned

  - `records` (integer)
    The maximum number of results returned per page

  - `entries` (array)
    List of transfers matching the given criteria

  - `entries.self` (string)
    URI of the transfer resource

  - `entries.status` (string)
    Current status of the transfer

  - `entries.initiated` (string)
    The date and time at which the transfer was initiated

  - `entries.sender` (object)

  - `entries.sender.self` (string)
    URI of the account resource

  - `entries.sender.number` (string)
    Immutable identifier attached to the account

  - `entries.sender.username` (string)
    Unique username attached to the account

  - `entries.sender.email` (string)
    Unique email address attached to the account

  - `entries.sender.firstName` (string)
    The account holder's forename

  - `entries.sender.lastName` (string)
    The account holder's surname

  - `entries.recipient` (object)

  - `entries.tickets` (array)
    List of tickets involved in the transfer

  - `entries.tickets.name` (string)
    The event section of the ticket being transferred

  - `entries.tickets.description` (string)
    Detailed description of the transferred ticket

  - `entries.tickets.quantity` (number)
    Number of tickets for this section being transferred

  - `entries.claims` (string)
    URI for the claims collection used to complete the transfer

## Response 400 fields (application/json):

  - `message` (string)
    Reason for the given response.

## Response 404 fields (application/json):

  - `message` (string)
    Reason for the given response.