Get all payout entities

GET /payout_entities

Responses

  • An array of payout entities defined by the organization.

    Hide response attribute Show response attribute object
    • results array[object] Required

      An array of payout entities defined by the organization.

      Not more than 1000 elements.

      Hide results attributes Show results attributes array[object]
      • payout_entity_id string Required

        The ID to be associated with the payout entity for future requests. If not provided on payout entity creation, Canopy will generate this field.

      • Type of associated entity

        Values are merchant, lender, sponsor, or organization.

      • Entity's name.

      • external_fields array[object]

        An Array of External Fields. These should be used to connect entities created in Canopy to data in your system and any connected external systems.

        Not more than 1000 elements.

        Hide external_fields attributes Show external_fields attributes array[object]
        • key string

          key: i.e. Name of the External Party

        • value string

          value: i.e. External Account ID

      • A Canopy-generated ID for the parent of this associated entity to establish a parent-child relationship.

      • Account number of the bank account for payment distributions.

      • Routing number of the bank account for payment distributions.

  • Unauthorized.

  • Forbidden.

  • Too many requests.

  • Unexpected Error.

GET /payout_entities
curl \
 -X GET https://sandbox-api.canopyservicing.com/payout_entities \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "results": [
    {
      "payout_entity_id": "0x1234",
      "payout_entity_type": "lender",
      "payout_entity_name": "Wonka Industries",
      "external_fields": [
        {
          "key": "Umbrella Corporation",
          "value": "22445702-a389-431f-927d-07b8d0750787"
        }
      ],
      "parent_payout_entity_id": "31mNprzLd2bKl6koVna68ARM",
      "bank_account_number": "1001001234",
      "bank_routing_number": "012345678"
    }
  ]
}
Response examples (200)
{
  "results": [
    {
      "payout_entity_id": "0x1234",
      "payout_entity_type": "lender",
      "payout_entity_name": "Wonka Industries",
      "external_fields": [
        {
          "key": "Umbrella Corporation",
          "value": "22445702-a389-431f-927d-07b8d0750787"
        }
      ],
      "parent_payout_entity_id": "31mNprzLd2bKl6koVna68ARM",
      "bank_account_number": "1001001234",
      "bank_routing_number": "012345678"
    }
  ]
}