External Customers

External customers are customers outside the University who buy goods and services from the University and generate accounts receivable balances. Some examples of external customers include private corporations, organizations, individuals, government agencies, external sponsors, and other UW institutions.

Commonly just called “customers”, the “external” qualifier is used for clarity.

Whenever external customers buy goods and services from the University, this creates a Customer Invoice record.

Filters

This endpoint allows filtering on all attributes (see the Filters documentation for more information). As of August 2026, these attributes are:

• active
• address:
  • address.addressId
  • address.addressLine1
  • address.addressLine2
  • address.addressUsage
  • address.city
  • address.countryCode
  • address.stateCode
• billToContacts:
  • billToContacts.email
  • billToContacts.name
  • billToContacts.referenceId
• id
• name
• referenceId
• lastModified

Example response element

{
  "attributes": {
    "active": true,
    "address": [
      {
        "addressId": "ADDRESS_REFERENCE-6-535792",
        "addressLine1": "1234 Washington Ave",
        "addressLine2": "Suite 200",
        "addressUsage": "Remit To; Billing; Shipping",
        "city": "Madison",
        "countryCode": "USA",
        "stateCode": "WI"
      }
    ],
    "billToContacts": [
      {
        "email": "accountspayable@acme.edu",
        "name": "Accounts Payable",
        "referenceId": "ARMSN_AR-0000001_AR-1"
      }
    ],
    "name": "Acme organization",
    "referenceId": "ARMSNAR-0000001"
  },
  "id": "CUS0000001",
  "links": {
    "self": "https://api.wisc.edu/finance/externalCustomers/CUS0000001"
  },
  "meta": {
    "lastModified": "2026-06-15T13:11:13"
  },
  "type": "externalCustomers"
}

Sample Filters

• api.wisc.edu/finance/externalCustomers?filter[active]=true&filter[address.city]=Madison,Milwaukee&filter[address.stateCode]=WI
• api.wisc.edu/finance/externalCustomers?filter[name]=STARTS_WITH:NSF&filter[billToContacts.name]=Accounts Payable