> ## 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.

# Tax Returns

> Verify income through tax preparation software connections

Verify income instantly through tax preparation software connections. Skip the wait for IRS tax returns and 4506-C documents while improving conversion rates.

Truv supports connections to major tax preparation software providers through [Truv Bridge](/developers/sdks/overview), including F1040 document support.

***

## Configure bridge token

When creating a [Bridge Token](/api-reference/bridge-token/users_tokens), include `product_type = income` and `data_sources = ["tax"]`:

```bash theme={null}
curl -X POST https://prod.truv.com/v1/users/{user_id}/tokens/ \
  -H "X-Access-Client-Id: YOUR_TRUV_CLIENT_ID" \
  -H "X-Access-Secret: YOUR_TRUV_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "income",
    "data_sources": ["tax"],
    "tracking_info": "any data for tracking"
  }'
```

***

## Example response

The JSON data below is a sample payload from the tax documents endpoint:

```json theme={null}
[
  {
    "id": "24d7e80942ce4ad58a93f70ce4115f5c",
    "document_type": "F1040",
    "document_subtype": "",
    "file": "https://example.com/tax_sample.pdf",
    "md5sum": "24d7e80942ce4ad58a93f70ce4115f5c",
    "year": 2019
  }
]
```

***

## Testing

Use the credentials below for sandbox testing:

| Username        | Password       | SSN           | Scenario                            |
| --------------- | -------------- | ------------- | ----------------------------------- |
| `goodlogin.tax` | `goodpassword` | `991-91-9991` | Successful login with complete data |

### Error Scenarios

| Username     | Password         | Scenario                          |
| ------------ | ---------------- | --------------------------------- |
| `error.user` | `login_error`    | Incorrect login and password      |
| `error.user` | `mfa_error`      | Multi-factor authentication issue |
| `error.user` | `account_locked` | Locked account                    |
| `error.user` | `no_data`        | No data found                     |
| `error.user` | `unavailable`    | Provider maintenance              |
| `error.user` | `error`          | Generic login error               |

***

## API reference

<CardGroup cols={2}>
  <Card title="Tax Documents" icon="file-invoice" href="/api-reference/tax/object">
    Tax document schema and endpoints
  </Card>

  <Card title="Bridge Token" icon="key" href="/api-reference/bridge-token/object">
    Create tokens for Truv Bridge
  </Card>

  <Card title="Users" icon="user" href="/api-reference/users/object">
    Create and manage users
  </Card>
</CardGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Document Processing" icon="file-arrow-up" href="/credit/data-sources/document-processing">
    Upload and process documents
  </Card>
</CardGroup>