---
title: "List funding recipients"
method: GET
path: "/funding-recipients"
tags: ["fundingRecipients"]
---

# List funding recipients

`GET /funding-recipients`

Use this method to return a [paginated](https://docs.payroc.com/api/pagination) list of funding recipients linked to your account.  

Note: If you want to view the details of a specific funding recipient and you have its recipientId, use our [Retrieve Funding Recipient](https://docs.payroc.com/api/schema/funding/funding-recipients/retrieve) method.  

Our gateway returns the following information about each funding recipient in the list:  
- Tax ID and Doing Business As (DBA) name.  
- Address and contact details.  
- Funding accounts linked to the funding recipient.  

For each funding recipient, we also return the recipientId, which you can use to perform follow-on actions.

## Query parameters

- `before` string
- `after` string
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns a paginated list of all funding recipients.

- PaginatedFundRecipients — Contains the pagination properties that you use to navigate through a list of results.
  - `limit` integer — Maximum number of results that we return for each page.
  - `count` integer — Number of results we returned on this page. **Note:** This might not be the total number of results that match your query.
  - `hasMore` boolean — Indicates whether there is another page of results available.
  - `links` Link[] — Reference links to navigate to the previous page of results or to the next page of results.
    - `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.
  - `data` FundingRecipient[] — An array of funding recipients
    - `recipientId` integer — Unique identifier that we assigned to the funding recipient.
    - `status` 'approved' | 'rejected' | 'pending' — Indicates if we have approved the funding recipient.
    - `createdDate` string, date-time — Date the funding recipient was created.
    - `lastModifiedDate` string, date-time — Date the funding recipient was last modified.
    - `recipientType` 'privateCorporation' | 'publicCorporation' | 'nonProfit' | 'government' | 'privateLlc' | 'publicLlc' | 'privatePartnership' | 'publicPartnership' | 'soleProprietor', required — Type or legal structure of the funding recipient.
    - `taxId` string, required — Employer identification number (EIN) or Social Security number (SSN).
    - `charityId` string — Government identifier of the charity.
    - `doingBusinessAs` string, required — Legal name of the business or organization.
    - `address` FundingRecipientAddress, required — Object that contains information about the address.
      - `address1` string, required — Address line 1.
      - `address2` string — Address line 2.
      - `address3` string — Address line 3.
      - `city` string, required — City.
      - `state` string, required — Name of the state or state abbreviation.
      - `country` string, required — Two-digit country code for the country that the business operates in. The format follows the [ISO-3166-1](https://www.iso.org/iso-3166-country-codes.html) standard.
      - `postalCode` string, required — Zip code or postal code.
    - `contactMethods` ContactMethod[], required — Array of polymorphic objects, which contain contact information. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number
      - union
        - object — email variant
          - `type` 'email', required — Discriminator value: email
          - `value` string, required — Email address.
        - object — phone variant
          - `type` 'phone', required — Discriminator value: phone
          - `value` string, required — Phone number.
        - object — mobile variant
          - `type` 'mobile', required — Discriminator value: mobile
          - `value` string, required — Mobile number.
        - object — fax variant
          - `type` 'fax', required — Discriminator value: fax
          - `value` string, required — Fax number.
    - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
    - `owners` FundingRecipientOwnersItems[], required — Array of owner objects associated with the funding recipient.
      - `ownerId` integer — Unique identifier of the owner.
      - `link` FundingRecipientOwnersItemsLink — Object that contains HATEOAS links for the resource.
        - `rel` string — Indicates the relationship between the current resource and the target resource.
        - `href` string — URL of the target resource.
        - `method` string — HTTP method that you need to use with the target resource.
    - `fundingAccounts` FundingRecipientFundingAccountsItems[], required — Array of fundingAccount objects associated with the funding recipient.
      - `fundingAccountId` integer — Unique identifier of the funding account.
      - `status` 'approved' | 'rejected' | 'pending' | 'hold' — Status of the funding account.
      - `link` FundingRecipientFundingAccountsItemsLink — Object that contains HATEOAS links for the resource.
        - `rel` string — Indicates the relationship between the current resource and the target resource.
        - `href` string — URL of the target resource.
        - `method` string — HTTP method that you need to use with the target resource.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `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-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)