List Vendors

Returns a paginated list of Vendors where the default and maximum limits are both 150.

Loading API schema for Vendor…

GET/api/v1/vendors

bash

curl -X GET "https://api.nx-us.net/api/v1/vendors" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Connection-Id: YOUR_CONNECTION_ID" \
  -H "Accept: application/json"

Response200

json

{
  "requestId": "<string>",
  "success": "<boolean>",
  "data": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "name": "Acme Corporation",
      "createdAt": "<date-time>",
      "updatedAt": "<date-time>",
      "revisionNumber": "<string>",
      "companyName": "Acme Corporation",
      "salutation": "Dr.",
      "firstName": "John",
      "middleName": "A.",
      "lastName": "Doe",
      "jobTitle": "Purchasing Manager",
      "phone": "+1-555-123-4567",
      "alternatePhone": "<string>",
      "fax": "+1-555-555-1212",
      "email": "vendor@example.com",
      "ccEmail": "<string>",
      "contact": "Jane Smith",
      "alternateContact": "<string>",
      "nameOnCheck": "Acme Supplies Ltd.",
      "accountNumber": "1010",
      "note": "<string>",
      "class": {},
      "vendorType": {},
      "terms": {},
      "billingRate": {},
      "salesTaxCode": {},
      "salesTaxReturn": {},
      "purchaseTaxAccount": {},
      "salesTaxAccount": {},
      "currency": {},
      "defaultExpenseAccounts": [],
      "billingAddress": {},
      "shippingAddress": {},
      "customContactFields": [],
      "additionalContacts": [],
      "additionalNotes": [],
      "balance": "1000.00",
      "creditLimit": "5000.00",
      "taxIdentificationNumber": "<string>",
      "isEligibleFor1099": "<boolean>",
      "isTaxAgency": "<boolean>",
      "salesTaxCountry": "us",
      "isSalesTaxAgency": "false",
      "taxRegistrationNumber": "GB123456789",
      "reportingPeriod": "quarterly",
      "isTrackingPurchaseTax": "<boolean>",
      "isTrackingSalesTax": "<boolean>",
      "isCompoundingTax": "<boolean>",
      "externalId": "<uuid>",
      "isActive": "<boolean>",
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "count": "<integer>",
  "limit": "<integer>",
  "totalCount": "<integer>",
  "timestamp": "<date-time>",
  "nextCursor": "<string>",
  "hasMore": "<boolean>",
  "remainingCount": "<integer>"
}