> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The User Deposit Switch Object

> Find reference information on this page for Direct Deposit Switch (DDS) reports.

Direct Deposit Switch (DDS) reports contain financial institution information from the user’s accounts. Learn more below about the data provided from reports.

# Attributes

The tables below cover the fields and descriptions from the responses.

| Attribute     | Type             | Description                                             |
| :------------ | :--------------- | :------------------------------------------------------ |
| completed\_at | date-time        | Timestamp when report was completed                     |
| links         | array of objects | List of assets links, see [Links object](#links-object) |

## Links object

The attributes and descriptions below are for the Links object.

| Attribute        | Type   | Description                                                                                                                                  |
| :--------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------- |
| link\_id         | string | Unique identifier of Link                                                                                                                    |
| tracking\_info   | string | Additional optional identifier passed by user                                                                                                |
| access\_token    | string | Access token of existing Link                                                                                                                |
| provider         | object | Provider information, see [Provider object](#provider-object)                                                                                |
| deposit\_details | object | Bank account info,  for Direct Deposit Switch (DDS) and Paycheck Linked Lending (PLL), see [Deposit details object](#deposit-details-object) |

### Provider object

The values in the table below are for the Provider object.

| Attribute                         | Type             | Description                            |
| :-------------------------------- | :--------------- | :------------------------------------- |
| id                                | string           | Data provider identifier               |
| supported\_bank\_account\_actions | array of strings | List of supported bank account actions |

### Deposit details object

View the info for the deposit details object below.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        account\_number
      </td>

      <td>
        string
      </td>

      <td>
        Account number
      </td>
    </tr>

    <tr>
      <td>
        account\_type
      </td>

      <td>
        string
      </td>

      <td>
        Account type, see possible values below

        `checking` - Checking account\
        `savings` - Savings account
      </td>
    </tr>

    <tr>
      <td>
        routing\_number
      </td>

      <td>
        string
      </td>

      <td>
        Routing number
      </td>
    </tr>

    <tr>
      <td>
        bank\_name
      </td>

      <td>
        string
      </td>

      <td>
        Bank name
      </td>
    </tr>

    <tr>
      <td>
        deposit\_type
      </td>

      <td>
        string
      </td>

      <td>
        Deposit type, see possible values below

        `entire` - Entire paycheck\
        `percent` - Percentage of paycheck\
        `amount` - Fixed amount from paycheck
      </td>
    </tr>

    <tr>
      <td>
        deposit\_value
      </td>

      <td>
        string
      </td>

      <td>
        Deposit value
      </td>
    </tr>
  </tbody>
</Table>

# Endpoint

The page below is for the available endpoint for DDS reports.

* [Retrieve a deposit switch report](/api-reference/dds-reports/dds-report-retrieve)

# Example response

The JSON below is an example DDS report response.

```json theme={null}
{
  "completed_at": "2022-05-04T11:30:00Z",
  "links": [
    {
      "link_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tracking_info": "string",
      "access_token": "99dd17074ac94aa9ace2621d657c7610",
      "provider": {
        "id": "adp",
        "supported_bank_account_actions": [
          "create"
        ]
      },
      "deposit_details": {
        "account_number": "16002600",
        "account_type": "checking",
        "routing_number": "123456789",
        "bank_name": "TD Bank",
        "deposit_type": "entire",
        "deposit_value": "50.00"
      }
    }
  ]
}
```
