---
title: "Retrieve funding account"
method: GET
path: "/funding-accounts/{fundingAccountId}"
tags: ["fundingAccounts"]
---

# Retrieve funding account

`GET /funding-accounts/{fundingAccountId}`

## Request

- Base URL: `https://api.payroc.com/v1`
- URL: `https://api.payroc.com/v1/funding-accounts/{fundingAccountId}`
- Auth: HTTP bearer

Use this method to retrieve information about a funding account.  

To retrieve a funding account, you need its fundingAccountId. Our gateway returned the fundingAccountId when you created the funding account.  

**Note:** If you don't have the fundingAccountId, use our [List Funding Accounts](https://docs.payroc.com/api/schema/funding/funding-accounts/list) method to search for the account.  

Our gateway returns the following information about the funding account:  
- Name of the account holder and ACH details for the account.  
- Status of the account.  
- Whether we send funds to the account, withdraw funds from the account, or both.

## Path parameters

- `fundingAccountId` integer, required

## Response `200`

Successful request. Returns the requested funding account.

- FundingAccount
  - `fundingAccountId` integer: Unique identifier that we assigned to the funding account.
  - `createdDate` string, date-time: Date and time that we received your request to create the funding account in our system.
  - `lastModifiedDate` string, date-time: Date and time that the funding account was last modified.
  - `status` 'approved' | 'rejected' | 'pending' | 'hold': Status of the funding account. The value is one of the following: - `approved` - We approved the funding account. - `rejected` - We rejected the funding account. - `pending` - We have not yet approved the funding account. - `hold` - Our Risk team have temporarily placed a hold on the funding account.
  - `type` 'checking' | 'savings' | 'generalLedger', required: Type of funding account.
  - `use` 'credit' | 'debit' | 'creditAndDebit', required: Indicates if we send funds or withdraw funds from the account. - `credit` - Send funds to the account. - `debit` - Withdraw funds from the account. - `creditAndDebit` - Send funds and withdraw funds from the account. **Note:** If the funding account is associated with a funding recipient, we accept only a value of `credit`.
  - `nameOnAccount` string, required: Name of the account holder.
  - `paymentMethods` PaymentMethodsItems[], required: Array of PaymentMethodAch objects.
    - `type` 'ach', required: Discriminator value: ach
    - `value` PaymentMethodsItemsDiscriminatorMappingAchValue: Object that contains information about the funding account.
      - `routingNumber` string, required: Routing number of the funding account.
      - `accountNumber` string, required: Account number of the funding account.
  - `metadata` object: [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
  - `links` Link[]: Array of HATEOAS links.
    - `rel` string, required: Indicates the relationship between the current resource and the target resource.
    - `method` string, required: HTTP method that you need to use with the target resource.
    - `href` string, required: URL of the target resource.

## Other responses

- `400`: Invalid request
- `401`: Identity could not be verified
- `403`: Do not have permissions to perform this action
- `404`: Resource not found
- `500`: An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) - [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) - [OpenAPI document](https://skmtc.dev/payroc/apis/schema/revisions/735467f6d8cd?raw)