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

# Account Holder Funding Sources

> Use account holder funding sources to enable access to funds outside the Marqeta platform for your account holders.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Use the `/fundingsources/ach`, `/fundingsources/ach/partner`, and `/fundingsources/paymentcard` endpoints to create account holder funding sources. A funding source enables access to funds outside of the Marqeta platform.

For more information on users and businesses, see [About Account Holders](/developer-guides/about-account-holders/).

<h2 id="post_fundingsources_ach">
  Create ACH source
</h2>

**Action:** `POST`\
**Endpoint:** `/fundingsources/ach`

{/* <EndpointCard
title="Registers an ACH funding source"
path="/fundingsources/ach"
method="post"
/> */}

Create an ACH funding source for an existing account holder. Specify the account holder of the funding source by passing a user or business token.

The response body returns details about the account, including the verification status. Possible ACH verification status values include `ACH_VERIFIED`, `ACH_FAILED`, and `VERIFICATION_PENDING`.

<h3 id="_request_body">
  Request body
</h3>

| Fields                                                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_number<br /><br />string<br /><br />Required         | ACH account number.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                                          |
| account\_type<br /><br />string<br /><br />Required           | Type of account.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                                                                                                                                                                                              |
| bank\_name<br /><br />string<br /><br />Optional              | Name of the financial institution where the ACH account is held.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                            |
| business\_token<br /><br />string<br /><br />Optional         | Unique identifier of the business account holder. This token is required if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                                                  |
| is\_default\_account<br /><br />boolean<br /><br />Optional   | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false`                                                                                                                                 |
| name\_on\_account<br /><br />string<br /><br />Required       | Name on the ACH account.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                                                                                                                                      |
| routing\_number<br /><br />string<br /><br />Required         | Routing number for the ACH account.<br /><br />**Allowable Values:**<br /><br />9 digits                                                                                                                                                                                                                                                                                                                                                             |
| token<br /><br />string<br /><br />Optional                   | Unique identifier of the funding source. If you do not include a token, the system will generate one automatically. This token is necessary for use in other calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                             |
| user\_token<br /><br />string<br /><br />Optional             | Unique identifier of the user account holder. This token is required if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                                                                                                                                                                  |
| verification\_notes<br /><br />string<br /><br />Optional     | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                   |
| verification\_override<br /><br />boolean<br /><br />Optional | Allows the ACH funding source to be used, regardless of its verification status. Set this field to `true` if you can attest that you have verified the account on your own and that it will not be returned by the Federal Reserve.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false` |

<h3 id="_sample_request_body">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_fundingsource_token_01",
  "user_token": "my_user_01",
  "routing_number": "121000358",
  "name_on_account": "Jane Doe",
  "is_default_account": false,
  "account_number": "987654321",
  "account_type": "savings",
  "verification_notes": "These are my verification notes.",
  "verification_override": true
}
```

<h3 id="_response_body">
  Response body
</h3>

| Fields                                                                                       | Description                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned                                        | ACH account identifier appended to the bank account number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                      |
| account\_type<br /><br />string<br /><br />Returned                                          | Type of account.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                                                                                   |
| active<br /><br />boolean<br /><br />Returned                                                | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                      |
| bank\_name<br /><br />string<br /><br />Conditionally returned                               | Name of the bank holding the account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                       |
| business\_token<br /><br />string<br /><br />Conditionally returned                          | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business token                                                                                                                                                          |
| created\_time<br /><br />datetime<br /><br />Returned                                        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                |
| date\_sent\_for\_verification<br /><br />datetime<br /><br />Conditionally returned          | Date and time in UTC when the request for account validation was sent to the third-party partner.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                   |
| date\_verified<br /><br />datetime<br /><br />Conditionally returned                         | Date and time when the account was verified, in UTC.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| is\_default\_account<br /><br />boolean<br /><br />Conditionally returned                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned                                 | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                          |
| name\_on\_account<br /><br />string<br /><br />Returned                                      | Name on the ACH account.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                           |
| partner<br /><br />string<br /><br />Conditionally returned                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                            |
| partner\_account\_link\_reference\_token<br /><br />string<br /><br />Conditionally returned | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                       |
| token<br /><br />string<br /><br />Returned                                                  | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                                                                                        |
| user\_token<br /><br />string<br /><br />Conditionally returned                              | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user token                                                                                                                                                              |
| verification\_notes<br /><br />string<br /><br />Conditionally returned                      | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                        |
| verification\_override<br /><br />boolean<br /><br />Conditionally returned                  | Allows the ACH funding source to be used regardless of its verification status. This field is returned if it exists in the resource.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                |
| verification\_status<br /><br />string<br /><br />Conditionally returned                     | Account verification status. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`ACH_FAILED`, `ACH_VERIFIED`, `VERIFICATION_PENDING`                                                                                                                                                        |

<h3 id="_sample_response_body">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_fundingsource_token_01",
  "created_time": "2023-02-26T18:46:06Z",
  "last_modified_time": "2023-03-26T12:44:02Z",
  "account_suffix": "4321",
  "verification_status": "ACH_VERIFIED",
  "account_type": "savings",
  "name_on_account": "Jane Doe",
  "active": true,
  "date_sent_for_verification": "2023-02-27T07:36:05Z",
  "user_token": "my_user_01",
  "is_default_account": false,
  "date_verified": "2023-02-27T11:03:45Z",
  "verification_override": true,
  "verification_notes": "These are my verification notes."
}
```

<h2 id="post_fundingsources_ach_partner">
  Create ACH source via a partner integration
</h2>

**Action:** `POST`\
**Endpoint:** `/fundingsources/ach/partner`

{/* <EndpointCard
title="Registers an ACH funding source through a partner"
path="/fundingsources/ach/partner"
method="post"
/> */}

Create an ACH funding source for an existing account holder by using a third-party partner to handle account validation and provide PII account data. Because you don’t handle any personally identifiable information (PII) yourself, using a third party when creating the funding source enables you to bypass the regulatory and compliance measures related to capturing, storing, and transmitting PII.

With this endpoint, you can create a US-based funding source—either a checking account or a savings account—for a program or user without passing bank account details such as the account number or routing number to Marqeta. Instead, validating account data and account verification is handled by the third-party partner you specify, and a secure token (i.e., a Plaid `processor_token`) is shared across partners. By using a secure account verification platform to provide immediate verification, you shorten the wait time until the ACH funding source is ready and avoid managing the microdeposit-based account verification process.

To create an ACH funding source for an existing account holder without validating through a third party, see [Create ACH source](/core-api/account-holder-funding-sources/#post_fundingsources_ach).

<Note>
  **Note**\
  This endpoint assumes that you already have established a relationship with both Marqeta and the third-party account validation partner you want to use. In addition, you must explicitly authorize the sharing of information with the third-party partner, and enable Marqeta as a processor for your integration. For more information, contact your Marqeta representative.
</Note>

<h3 id="_request_body_2">
  Request body
</h3>

| Fields                                                                         | Description                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| partner<br /><br />string<br /><br />Required                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                                                           |
| partner\_account\_link\_reference\_token<br /><br />string<br /><br />Required | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                      |
| user\_token<br /><br />string<br /><br />Optional                              | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. This token is required if a `business_token` is not specified.<br /><br />Send a `GET` request to `/users` to retrieve user tokens.<br /><br />**Allowable Values:**<br /><br />1–36 chars                         |
| is\_default\_account<br /><br />boolean<br /><br />Optional                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false`                                                     |
| token<br /><br />string<br /><br />Optional                                    | Unique identifier of the funding source. If you do not include a token, the system will generate one automatically. This token is necessary for use in other calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />1–36 chars |

<h3 id="_sample_request_body_2">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_fundingsource_token_01",
  "user_token": "my_user_01",
  "is_default_account": false,
  "partner": "PLAID",
  "partner_account_link_reference_token": "processor-sandbox-reference-token"
}
```

<h3 id="_response_body_2">
  Response body
</h3>

| Fields                                                                                       | Description                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned                                        | ACH account identifier appended to the bank account number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                      |
| account\_type<br /><br />string<br /><br />Returned                                          | Type of account.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                                                                                   |
| active<br /><br />boolean<br /><br />Returned                                                | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                      |
| bank\_name<br /><br />string<br /><br />Conditionally returned                               | Name of the bank holding the account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                       |
| business\_token<br /><br />string<br /><br />Conditionally returned                          | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business token                                                                                                                                                          |
| created\_time<br /><br />datetime<br /><br />Returned                                        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                |
| date\_sent\_for\_verification<br /><br />datetime<br /><br />Conditionally returned          | Date and time in UTC when the request for account validation was sent to the third-party partner.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                   |
| date\_verified<br /><br />datetime<br /><br />Conditionally returned                         | Date and time when the account was verified, in UTC.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| is\_default\_account<br /><br />boolean<br /><br />Conditionally returned                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned                                 | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                          |
| name\_on\_account<br /><br />string<br /><br />Returned                                      | Name on the ACH account.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                           |
| partner<br /><br />string<br /><br />Conditionally returned                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                            |
| partner\_account\_link\_reference\_token<br /><br />string<br /><br />Conditionally returned | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                       |
| token<br /><br />string<br /><br />Returned                                                  | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                                                                                        |
| user\_token<br /><br />string<br /><br />Conditionally returned                              | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user token                                                                                                                                                              |
| verification\_notes<br /><br />string<br /><br />Conditionally returned                      | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                        |
| verification\_override<br /><br />boolean<br /><br />Conditionally returned                  | Allows the ACH funding source to be used regardless of its verification status. This field is returned if it exists in the resource.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                |
| verification\_status<br /><br />string<br /><br />Conditionally returned                     | Account verification status. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`ACH_FAILED`, `ACH_VERIFIED`, `VERIFICATION_PENDING`                                                                                                                                                        |

<h3 id="_sample_response_body_2">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_fundingsource_token_01",
  "created_time": "2023-02-26T18:46:06Z",
  "last_modified_time": "2023-03-26T12:44:02Z",
  "account_suffix": "4321",
  "verification_status": "ACH_VERIFIED",
  "account_type": "savings",
  "name_on_account": "Jane Doe",
  "active": true,
  "date_sent_for_verification": "2023-02-27T07:36:05Z",
  "user_token": "my_user_01",
  "is_default_account": false,
  "date_verified": "2023-02-27T11:03:45Z",
  "verification_override": true,
  "verification_notes": "These are my verification notes.",
  "partner": "PLAID",
  "partner_account_link_reference_token": "processor-sandbox-reference-token"
}
```

<h2 id="get_fundingsources_ach_fundingsourcetoken">
  Retrieve ACH source
</h2>

**Action:** `GET`\
**Endpoint:** `/fundingsources/ach/{funding_source_token}`

{/* <EndpointCard
title="Returns a user ACH account"
path="/fundingsources/ach/{funding\_source\_token}"
method="get"
/> */}

Retrieve a specific ACH funding source.

The response body returns details about the account, including the verification status. Possible ACH verification status values are: `ACH_FAILED`, `ACH_VERIFIED`, and `VERIFICATION_PENDING`.

<h3 id="_url_path_parameters">
  URL path parameters
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| funding\_source\_token<br /><br />string<br /><br />Required | Unique identifier of the funding source.<br /><br />Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.<br /><br />**Allowable Values:**<br /><br />Existing ACH funding source token |

<h3 id="_response_body_3">
  Response body
</h3>

| Fields                                                                                       | Description                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned                                        | ACH account identifier appended to the bank account number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                      |
| account\_type<br /><br />string<br /><br />Returned                                          | Type of account.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                                                                                   |
| active<br /><br />boolean<br /><br />Returned                                                | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                                                                      |
| bank\_name<br /><br />string<br /><br />Conditionally returned                               | Name of the bank holding the account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                       |
| business\_token<br /><br />string<br /><br />Conditionally returned                          | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business token                                                                                                                                                          |
| created\_time<br /><br />datetime<br /><br />Returned                                        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                |
| date\_sent\_for\_verification<br /><br />datetime<br /><br />Conditionally returned          | Date and time in UTC when the request for account validation was sent to the third-party partner.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                   |
| date\_verified<br /><br />datetime<br /><br />Conditionally returned                         | Date and time when the account was verified, in UTC.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| is\_default\_account<br /><br />boolean<br /><br />Conditionally returned                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned                                 | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                          |
| name\_on\_account<br /><br />string<br /><br />Returned                                      | Name on the ACH account.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                                                                           |
| partner<br /><br />string<br /><br />Conditionally returned                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                            |
| partner\_account\_link\_reference\_token<br /><br />string<br /><br />Conditionally returned | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                       |
| token<br /><br />string<br /><br />Returned                                                  | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                                                                                        |
| user\_token<br /><br />string<br /><br />Conditionally returned                              | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user token                                                                                                                                                              |
| verification\_notes<br /><br />string<br /><br />Conditionally returned                      | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                        |
| verification\_override<br /><br />boolean<br /><br />Conditionally returned                  | Allows the ACH funding source to be used regardless of its verification status. This field is returned if it exists in the resource.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                |
| verification\_status<br /><br />string<br /><br />Conditionally returned                     | Account verification status. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`ACH_FAILED`, `ACH_VERIFIED`, `VERIFICATION_PENDING`                                                                                                                                                        |

<h3 id="_sample_response_body_3">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_user_01_fundingsource_token_01",
  "created_time": "2023-02-26T18:46:06Z",
  "last_modified_time": "2023-03-12T04:58:46Z",
  "account_suffix": "4321",
  "verification_status": "ACH_VERIFIED",
  "account_type": "savings",
  "name_on_account": "Jane Doe",
  "active": true,
  "date_sent_for_verification": "2023-02-27T18:00:00Z",
  "user_token": "my_user_01",
  "is_default_account": false,
  "date_verified": "2023-02-27T18:15:00Z",
  "verification_override": true,
  "verification_notes": "These are my verification notes."
}
```

<h2 id="get_fundingsources_business_businesstoken">
  List sources for business
</h2>

**Action:** `GET`\
**Endpoint:** `/fundingsources/business/{business_token}`

{/* <EndpointCard
title="Lists all funding sources for a business"
path="/fundingsources/business/{business\_token}"
method="get"
/> */}

List funding sources associated with a specific business.

This endpoint supports [field filtering](/core-api/field-filtering/).

<h3 id="_url_path_parameters_2">
  URL path parameters
</h3>

| Fields                                                | Description                                                                                                                                                                                                  |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| business\_token<br /><br />string<br /><br />Required | Unique identifier of the business account holder.<br /><br />Send a `GET` request to `/businesses` to retrieve business tokens.<br /><br />**Allowable Values:**<br /><br />Existing business resource token |

<h3 id="_url_query_parameters">
  URL query parameters
</h3>

| Fields                                       | Description                                                                                                                                                                                                                 |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| type<br /><br />string<br /><br />Optional   | Type of funding source to return: ACH or payment card. Leave unspecified to return both types.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`<br /><br />**Default value:**<br />unspecified (both types) |
| fields<br /><br />string<br /><br />Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields.<br /><br />**Allowable Values:**<br /><br />Comma-delimited list of fields, or blank                             |

<h3 id="_response_body_4">
  Response body
</h3>

| Fields                                                                                                   | Description                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Conditionally returned                                               | Number of resources to retrieve.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />1-10                                                                                                                                                                        |
| data<br /><br />array of objects<br /><br />Conditionally returned                                       | Array of funding account objects.<br /><br />Objects are returned as appropriate to your query.<br /><br />**Allowable Values:**<br /><br />Valid data array of one or more funding account objects                                                                                                                                       |
| data\[].**account\_suffix**<br /><br />string<br /><br />Conditionally returned                          | Account identifier appended to the bank account number. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                     |
| data\[].**account\_type**<br /><br />string<br /><br />Conditionally returned                            | Type of account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                              |
| data\[].**active**<br /><br />boolean<br /><br />Conditionally returned                                  | Specifies whether the account is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                 |
| data\[].**business\_token**<br /><br />string<br /><br />Conditionally returned                          | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business token                                                                                                                                                          |
| data\[].**created\_time**<br /><br />datetime<br /><br />Returned                                        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                |
| data\[].**date\_sent\_for\_verification**<br /><br />datetime<br /><br />Conditionally returned          | Date and time in UTC when the request for account validation was sent to the third-party partner.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                |
| data\[].**date\_verified**<br /><br />datetime<br /><br />Conditionally returned                         | Date and time when the account was verified, in UTC. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                           |
| data\[].**exp\_date**<br /><br />string<br /><br />Conditionally returned                                | Payment card expiration date. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                               |
| data\[].**is\_default\_account**<br /><br />boolean<br /><br />Conditionally returned                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| data\[].**last\_modified\_time**<br /><br />datetime<br /><br />Returned                                 | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                          |
| data\[].**name\_on\_account**<br /><br />string<br /><br />Conditionally returned                        | Name on the account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                          |
| data\[].**partner**<br /><br />string<br /><br />Conditionally returned                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                            |
| data\[].**partner\_account\_link\_reference\_token**<br /><br />string<br /><br />Conditionally returned | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                       |
| data\[].**token**<br /><br />string<br /><br />Conditionally returned                                    | Unique identifier of the funding source. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                                   |
| data\[].**type**<br /><br />string<br /><br />Conditionally returned                                     | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                                                                                     |
| data\[].**user\_token**<br /><br />string<br /><br />Conditionally returned                              | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user token                                                                                                                                                              |
| data\[].**verification\_notes**<br /><br />string<br /><br />Conditionally returned                      | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                        |
| data\[].**verification\_override**<br /><br />boolean<br /><br />Conditionally returned                  | Allows the ACH funding source to be used regardless of its verification status.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                     |
| data\[].**verification\_status**<br /><br />string<br /><br />Conditionally returned                     | Account verification status. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`ACH_FAILED`, `ACH_VERIFIED`, `VERIFICATION_PENDING`                                                                                                                                                        |
| end\_index<br /><br />integer<br /><br />Conditionally returned                                          | Sort order index of the last resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                     |
| is\_more<br /><br />boolean<br /><br />Conditionally returned                                            | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                      |
| start\_index<br /><br />integer<br /><br />Conditionally returned                                        | Sort order index of the first resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                    |

<h3 id="_sample_response_body_4">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "type": "paymentcard",
      "token": "my_paymentcard_funding_source_01",
      "created_time": "2023-02-26T21:26:13Z",
      "last_modified_time": "2023-02-26T21:26:13Z",
      "account_suffix": "4113",
      "account_type": "corporate",
      "active": true,
      "is_default_account": true,
      "exp_date": "1227",
      "user_token": "my_business_01"
    }
  ]
}
```

<h2 id="post_fundingsources_paymentcard">
  Create payment card source
</h2>

**Action:** `POST`\
**Endpoint:** `/fundingsources/paymentcard`

{/* <EndpointCard
title="Registers a payment card funding source"
path="/fundingsources/paymentcard"
method="post"
/> */}

Create a payment card funding source for an existing account holder. This endpoint returns the card type and the last four digits of the card, and then sets the `active_ field` to `true`.

Marqeta retains only a tokenized representation of the card number.

<h3 id="_request_body_3">
  Request body
</h3>

| Fields                                                      | Description                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_number<br /><br />string<br /><br />Required       | Payment card account number.<br /><br />**Allowable Values:**<br /><br />16-digit number                                                                                                                                                                                                                                                                                                |
| business\_token<br /><br />string<br /><br />Optional       | Unique identifier of the business account holder. This token is required if the `user_token` is not included.<br /><br />Send a `GET` request to `/businesses` to retrieve business tokens.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                      |
| cvv\_number<br /><br />string<br /><br />Required           | Payment card CVV2 number.<br /><br />**Allowable Values:**<br /><br />3–4 chars                                                                                                                                                                                                                                                                                                         |
| exp\_date<br /><br />string<br /><br />Required             | Payment card expiration date.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                                                                                                                                  |
| is\_default\_account<br /><br />boolean<br /><br />Optional | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false`                                                                    |
| postal\_code<br /><br />string<br /><br />Optional          | Postal code of the account holder (user or business).<br /><br />**Allowable Values:**<br /><br />10 char max                                                                                                                                                                                                                                                                           |
| token<br /><br />string<br /><br />Optional                 | Unique identifier of the funding account. If you do not include a token, the system will generate one automatically. As this token is necessary for use in other calls, we recommend that you define a simple and easy to remember string rather than letting the system generate a token for you. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />1–36 chars |
| user\_token<br /><br />string<br /><br />Optional           | Unique identifier of the user account holder. This token is required if the `business_token` is not included.<br /><br />Send a `GET` request to `/users` to retrieve user tokens.<br /><br />**Allowable Values:**<br /><br />1–36 chars                                                                                                                                               |
| zip<br /><br />string<br /><br />Optional                   | United States ZIP code of the account holder (user or business).<br /><br />**Allowable Values:**<br /><br />10 char max                                                                                                                                                                                                                                                                |

<h3 id="_sample_request_body_3">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "my_paymentcard_01",
  "postal_code": "94608",
  "user_token": "my_user_01",
  "is_default_account": true,
  "exp_date": "1227",
  "account_number": "6559906559906557",
  "cvv_number": "123"
}
```

<h3 id="_response_body_5">
  Response body
</h3>

| Fields                                                              | Description                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned               | Account identifier appended to the payment card number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                          |
| account\_type<br /><br />string<br /><br />Returned                 | Type of payment card account.<br /><br />**Allowable Values:**<br /><br />`checking`, `corporate`, `loan`, `savings`                                                                                                                                                      |
| active<br /><br />boolean<br /><br />Returned                       | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                      |
| business\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business resource token                                                                                 |
| created\_time<br /><br />datetime<br /><br />Returned               | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| exp\_date<br /><br />string<br /><br />Returned                     | Payment card expiration date.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                    |
| is\_default\_account<br /><br />boolean<br /><br />Returned         | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                          |
| token<br /><br />string<br /><br />Returned                         | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                        |
| type<br /><br />string<br /><br />Returned                          | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                     |
| user\_token<br /><br />string<br /><br />Conditionally returned     | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user resource token                                                                                     |

<h3 id="_sample_response_body_5">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "type": "paymentcard",
  "token": "my_paymentcard_01",
  "created_time": "2023-02-26T20:00:00Z",
  "last_modified_time": "2023-02-26T21:00:00Z",
  "account_suffix": "6557",
  "account_type": "corporate",
  "active": true,
  "is_default_account": true,
  "exp_date": "1227",
  "user_token": "my_user_01"
}
```

<h2 id="get_fundingsources_paymentcard_fundingsourcetoken">
  Retrieve payment card source
</h2>

**Action:** `GET`\
**Endpoint:** `/fundingsources/paymentcard/{funding_source_token}`

{/* <EndpointCard
title="Returns a specific payment card"
path="/fundingsources/paymentcard/{funding\_source\_token}"
method="get"
/> */}

Retrieve a specific payment card funding source.

<h3 id="_url_path_parameters_3">
  URL path parameters
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| funding\_source\_token<br /><br />string<br /><br />Required | Unique identifier of the funding source.<br /><br />Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.<br /><br />**Allowable Values:**<br /><br />Existing funding source token |

<h3 id="_response_body_6">
  Response body
</h3>

| Fields                                                              | Description                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned               | Account identifier appended to the payment card number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                          |
| account\_type<br /><br />string<br /><br />Returned                 | Type of payment card account.<br /><br />**Allowable Values:**<br /><br />`checking`, `corporate`, `loan`, `savings`                                                                                                                                                      |
| active<br /><br />boolean<br /><br />Returned                       | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                      |
| business\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business resource token                                                                                 |
| created\_time<br /><br />datetime<br /><br />Returned               | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| exp\_date<br /><br />string<br /><br />Returned                     | Payment card expiration date.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                    |
| is\_default\_account<br /><br />boolean<br /><br />Returned         | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                          |
| token<br /><br />string<br /><br />Returned                         | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                        |
| type<br /><br />string<br /><br />Returned                          | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                     |
| user\_token<br /><br />string<br /><br />Conditionally returned     | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user resource token                                                                                     |

<h3 id="_sample_response_body_6">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "type": "paymentcard",
  "token": "my_paymentcard_01",
  "created_time": "2023-02-26T20:00:00Z",
  "last_modified_time": "2023-02-26T21:00:00Z",
  "account_suffix": "6557",
  "account_type": "corporate",
  "active": true,
  "is_default_account": true,
  "exp_date": "1227",
  "user_token": "my_user_01"
}
```

<h2 id="put_fundingsources_fundingsourcetoken">
  Update payment card source
</h2>

**Action:** `PUT`\
**Endpoint:** `/fundingsources/paymentcard/{funding_source_token}`

{/* <EndpointCard
title="Updates a specific payment card"
path="/fundingsources/paymentcard/{funding\_source\_token}"
method="put"
/> */}

Update a payment card funding source.

<h3 id="_url_path_parameters_4">
  URL path parameters
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| funding\_source\_token<br /><br />string<br /><br />Required | Unique identifier of the funding source.<br /><br />Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.<br /><br />**Allowable Values:**<br /><br />Existing funding source token |

<h3 id="_request_body_4">
  Request body
</h3>

| Fields                                                      | Description                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| active<br /><br />boolean<br /><br />Optional               | Indicates whether the card funding source is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`true`                                                                                                                                                           |
| exp\_date<br /><br />string<br /><br />Required             | Expiration date for the payment card.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                                                       |
| is\_default\_account<br /><br />boolean<br /><br />Optional | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false`<br /><br />**Default value:**<br />`false` |

<h3 id="_sample_request_body_4">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "is_default_account": false,
  "exp_date": "1227"
}
```

<h3 id="_response_body_7">
  Response body
</h3>

| Fields                                                              | Description                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned               | Account identifier appended to the payment card number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                          |
| account\_type<br /><br />string<br /><br />Returned                 | Type of payment card account.<br /><br />**Allowable Values:**<br /><br />`checking`, `corporate`, `loan`, `savings`                                                                                                                                                      |
| active<br /><br />boolean<br /><br />Returned                       | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                      |
| business\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business resource token                                                                                 |
| created\_time<br /><br />datetime<br /><br />Returned               | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| exp\_date<br /><br />string<br /><br />Returned                     | Payment card expiration date.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                    |
| is\_default\_account<br /><br />boolean<br /><br />Returned         | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                          |
| token<br /><br />string<br /><br />Returned                         | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                        |
| type<br /><br />string<br /><br />Returned                          | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                     |
| user\_token<br /><br />string<br /><br />Conditionally returned     | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user resource token                                                                                     |

<h3 id="_sample_response_body_7">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "type": "paymentcard",
  "token": "my_paymentcard_01",
  "created_time": "2023-02-26T20:00:00Z",
  "last_modified_time": "2023-02-26T21:00:00Z",
  "account_suffix": "6557",
  "account_type": "DISCOVER",
  "active": true,
  "is_default_account": false,
  "exp_date": "1227",
  "user_token": "my_user_01"
}
```

<h2 id="get_fundingsources_user_usertoken">
  List sources for user
</h2>

**Action:** `GET`\
**Endpoint:** `/fundingsources/user/{user_token}`

{/* <EndpointCard
title="Lists all funding sources for a user"
path="/fundingsources/user/{user\_token}"
method="get"
/> */}

List funding sources associated with a specific user.

This endpoint supports [field filtering](/core-api/field-filtering/).

<h3 id="_url_path_parameters_5">
  URL path parameters
</h3>

| Fields                                            | Description                                                                                                            |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| user\_token<br /><br />string<br /><br />Required | Unique identifier of the user account holder.<br /><br />**Allowable Values:**<br /><br />Existing user resource token |

<h3 id="_url_query_parameters_2">
  URL query parameters
</h3>

| Fields                                       | Description                                                                                                                                                                                                                   |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| type<br /><br />string<br /><br />Optional   | Type of funding source to retrieve: ACH or payment card. Leave unspecified to return both types.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`<br /><br />**Default value:**<br />unspecified (both types) |
| fields<br /><br />string<br /><br />Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields.<br /><br />**Allowable Values:**<br /><br />Comma-delimited list of fields, or blank                               |

<h3 id="_response_body_8">
  Response body
</h3>

| Fields                                                                                                   | Description                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Conditionally returned                                               | Number of resources to retrieve.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />1-10                                                                                                                                                                        |
| data<br /><br />array of objects<br /><br />Conditionally returned                                       | Array of funding account objects.<br /><br />Objects are returned as appropriate to your query.<br /><br />**Allowable Values:**<br /><br />Valid data array of one or more funding account objects                                                                                                                                       |
| data\[].**account\_suffix**<br /><br />string<br /><br />Conditionally returned                          | Account identifier appended to the bank account number. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                     |
| data\[].**account\_type**<br /><br />string<br /><br />Conditionally returned                            | Type of account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`checking`, `savings`, `corporate`, `loan`                                                                                                                                                                              |
| data\[].**active**<br /><br />boolean<br /><br />Conditionally returned                                  | Specifies whether the account is active. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                 |
| data\[].**business\_token**<br /><br />string<br /><br />Conditionally returned                          | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business token                                                                                                                                                          |
| data\[].**created\_time**<br /><br />datetime<br /><br />Returned                                        | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                                |
| data\[].**date\_sent\_for\_verification**<br /><br />datetime<br /><br />Conditionally returned          | Date and time in UTC when the request for account validation was sent to the third-party partner.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Format: yyyy-MM-ddThh:mm:ssZ                                                                                                |
| data\[].**date\_verified**<br /><br />datetime<br /><br />Conditionally returned                         | Date and time when the account was verified, in UTC. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                           |
| data\[].**exp\_date**<br /><br />string<br /><br />Conditionally returned                                | Payment card expiration date. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                               |
| data\[].**is\_default\_account**<br /><br />boolean<br /><br />Conditionally returned                    | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| data\[].**last\_modified\_time**<br /><br />datetime<br /><br />Returned                                 | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                                                                          |
| data\[].**name\_on\_account**<br /><br />string<br /><br />Conditionally returned                        | Name on the account. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />1–50 chars                                                                                                                                                                                                          |
| data\[].**partner**<br /><br />string<br /><br />Conditionally returned                                  | Name of the partner who validated the account holder. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />`PLAID`                                                                                                                                                            |
| data\[].**partner\_account\_link\_reference\_token**<br /><br />string<br /><br />Conditionally returned | Supplied by the account validation partner, this value is a reference to the account holder’s details, such as the account number and routing number. Returned when a third-party partner was used for account validation.<br /><br />**Allowable Values:**<br /><br />255 char max                                                       |
| data\[].**token**<br /><br />string<br /><br />Conditionally returned                                    | Unique identifier of the funding source. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                                   |
| data\[].**type**<br /><br />string<br /><br />Conditionally returned                                     | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                                                                                     |
| data\[].**user\_token**<br /><br />string<br /><br />Conditionally returned                              | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user token                                                                                                                                                              |
| data\[].**verification\_notes**<br /><br />string<br /><br />Conditionally returned                      | Free-form text field for holding notes about verification. This field is returned only if `verification_override = true`.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                        |
| data\[].**verification\_override**<br /><br />boolean<br /><br />Conditionally returned                  | Allows the ACH funding source to be used regardless of its verification status.<br /><br />**NOTE:** When using `PLAID` to validate a funding source, this field is always set to `true`.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                     |
| data\[].**verification\_status**<br /><br />string<br /><br />Conditionally returned                     | Account verification status. This field is returned if it exists in the resource.<br /><br />**Allowable Values:**<br /><br />`ACH_FAILED`, `ACH_VERIFIED`, `VERIFICATION_PENDING`                                                                                                                                                        |
| end\_index<br /><br />integer<br /><br />Conditionally returned                                          | Sort order index of the last resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                     |
| is\_more<br /><br />boolean<br /><br />Conditionally returned                                            | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                      |
| start\_index<br /><br />integer<br /><br />Conditionally returned                                        | Sort order index of the first resource in the returned array.<br /><br />This field is returned if there are resources in your returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                                                                                    |

<h3 id="_sample_response_body_8">
  Sample response body
</h3>

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 1,
  "is_more": false,
  "data": [
    {
      "type": "paymentcard",
      "token": "jane_doe_paymentcard_01",
      "account_suffix": "4113",
      "account_type": "corporate",
      "active": true,
      "is_default_account": true,
      "exp_date": "1227",
      "user_token": "my_user_01",
      "created_time": "2023-02-26T20:03:05Z",
      "last_modified_time": "2023-02-26T20:03:05Z"
    },
    {
      "type": "ach",
      "token": "jane_doe_ach_token",
      "account_suffix": "4321",
      "account_type": "savings",
      "active": false,
      "is_default_account": false,
      "verification_status": "ACH_VERIFIED",
      "user_token": "my_user_01",
      "name_on_account": "Jane Doe",
      "date_sent_for_verification": "2023-02-27T23:27:58Z",
      "created_time": "2023-02-26T20:03:05Z",
      "last_modified_time": "2023-02-26T20:03:05Z"
    }
  ]
}
```

<h2 id="put_fundingsources_fundingsourcetoken_default">
  Set default source
</h2>

**Action:** `PUT`\
**Endpoint:** `/fundingsources/{funding_source_token}/default`

{/* <EndpointCard
title="Configures a default funding source"
path="/fundingsources/{funding\_source\_token}/default"
method="put"
/> */}

Configure either an ACH funding source or a payment card funding source as the default funding source.

A default funding source is used when you omit the `funding_source_token` field from funding requests, such as a `POST` request to `/gpaorders`. Note that the first funding source you create is automatically set as the default (`is_default_source=true`).

<h3 id="_url_path_parameters_6">
  URL path parameters
</h3>

| Fields                                                       | Description                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| funding\_source\_token<br /><br />string<br /><br />Required | Unique identifier of the funding source.<br /><br />Send a `GET` request to `/fundingsources/user/{user_token}` to retrieve existing funding source tokens for a user or to `/fundingsources/business/{business_token}` to retrieve existing funding source tokens for a business.<br /><br />**Allowable Values:**<br /><br />Existing funding source token |

<h3 id="_response_body_9">
  Response body
</h3>

| Fields                                                              | Description                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_suffix<br /><br />string<br /><br />Returned               | Account identifier appended to the payment card number.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                          |
| account\_type<br /><br />string<br /><br />Returned                 | Type of payment card account.<br /><br />**Allowable Values:**<br /><br />`checking`, `corporate`, `loan`, `savings`                                                                                                                                                      |
| active<br /><br />boolean<br /><br />Returned                       | Specifies whether the account is active.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                      |
| business\_token<br /><br />string<br /><br />Conditionally returned | Unique identifier of the business account holder. This token is returned if a `user_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing business resource token                                                                                 |
| created\_time<br /><br />datetime<br /><br />Returned               | Date and time when the resource was created, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                                |
| exp\_date<br /><br />string<br /><br />Returned                     | Payment card expiration date.<br /><br />**Allowable Values:**<br /><br />Format: MMyy                                                                                                                                                                                    |
| is\_default\_account<br /><br />boolean<br /><br />Returned         | If there are multiple funding sources, this field specifies which source is used by default in funding calls. If there is only one funding source, the system ignores this field and always uses that source.<br /><br />**Allowable Values:**<br /><br />`true`, `false` |
| last\_modified\_time<br /><br />datetime<br /><br />Returned        | Date and time when the resource was last modified, in UTC.<br /><br />**Allowable Values:**<br /><br />datetime<br /><br />**Format:**<br />yyyy-MM-ddThh:mm:ssZ                                                                                                          |
| token<br /><br />string<br /><br />Returned                         | Unique identifier of the funding source.<br /><br />**Allowable Values:**<br /><br />Existing funding source token                                                                                                                                                        |
| type<br /><br />string<br /><br />Returned                          | Funding source type.<br /><br />**Allowable Values:**<br /><br />`ACH`, `paymentcard`                                                                                                                                                                                     |
| user\_token<br /><br />string<br /><br />Conditionally returned     | Unique identifier of the user account holder. This token is returned if a `business_token` is not specified.<br /><br />**Allowable Values:**<br /><br />Existing user resource token                                                                                     |

<h3 id="_sample_response_body_9">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "type": "paymentcard",
  "token": "jane_doe_paymentcard_token",
  "account_suffix": "4321",
  "account_type": "corporate",
  "active": true,
  "exp_date": "1227",
  "is_default_account": true,
  "user_token": "my_user_01",
  "created_time": "2023-02-28T20:00:00Z",
  "last_modified_time": "2023-02-28T20:00:00Z"
}
```


## Related topics

- [Platform Overview](/docs/developer-guides/platform-overview.md)
- [Funding via ACH](/docs/core-api/funding-via-ach.md)
- [2022 Release Notes](/docs/developer-guides/release-notes-2022.md)
- [ACH Origination](/docs/developer-guides/ach-origination.md)
- [Program Funding Sources](/docs/core-api/program-funding-sources.md)
