--- title: "List all Vendors" method: GET path: "/vendor.json" tags: ["Vendors"] --- # List all Vendors `GET /vendor.json` Vendor account information #### Filtering This endpoint supports result filtering. For more information on how to filter this request, [go here](/docs/filtering). #### OAuth Scope This endpoint requires the following OAuth scope **vendor**. ## Response `200` An array of Vendors - Vendor[] - `business_number` string — Company Business Number - `email` string, email — Primary email address for the company. Used for system notifications, customer communications, and as the default sender address for emails sent from the system. - `email_accounts` string — Accounts/billing email accounts configured for the company. - `billing_address` string — The company's billing address where invoices and financial correspondence should be sent. - `accepted_payment_methods` unknown - `default_region` string — Default geographic region for the company. Affects currency, tax calculations, date formats, and other region-specific behaviors in the system. - `currency` string — Three-letter ISO currency code (e.g., 'USD', 'AUD', 'EUR') representing the company's primary currency. Used for all financial calculations and displays in the system. - `opening_time_monday` string — The minute of the day (from midnight) when the business opens on Monday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_monday` string — The minute of the day (from midnight) when the business closes on Monday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_tuesday` string — The minute of the day (from midnight) when the business opens on Tuesday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_tuesday` string — The minute of the day (from midnight) when the business closes on Tuesday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_wednesday` string — The minute of the day (from midnight) when the business opens on Wednesday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_wednesday` string — The minute of the day (from midnight) when the business closes on Wednesday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_thursday` string — The minute of the day (from midnight) when the business opens on Thursday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_thursday` string — The minute of the day (from midnight) when the business closes on Thursday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_friday` string — The minute of the day (from midnight) when the business opens on Friday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_friday` string — The minute of the day (from midnight) when the business closes on Friday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_saturday` string — The minute of the day (from midnight) when the business opens on Saturday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_saturday` string — The minute of the day (from midnight) when the business closes on Saturday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `opening_time_sunday` string — The minute of the day (from midnight) when the business opens on Sunday. For example, 480 represents 8:00 AM (8 hours × 60 minutes). Used for scheduling and availability calculations. - `closing_time_sunday` string — The minute of the day (from midnight) when the business closes on Sunday. For example, 1020 represents 5:00 PM (17 hours × 60 minutes). Used for scheduling and availability calculations. - `timezone_name` string — IANA timezone name (e.g., 'America/New_York', 'Australia/Sydney') for the company's primary location. Used for date/time calculations, scheduling, and display of times across the system. - `invoice_terms` string — Text describing the payment terms that appear on invoices. For example, '14 days', 'Net 30', etc. Used to communicate payment expectations to customers on invoices and financial documents. - `job_default_status` string — Default status for new jobs created in the system. Valid values are 'Quote' or 'Work Order'. Controls the initial state of newly created jobs. - `uuid` string, uuid — Unique identifier for this record - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1] - `edit_date` string — Timestamp at which record was last modified - `name` string, required — Company Name - `abn_number` string - `website` string — Company Website address ## Other responses - `400` — Bad Request - The request is malformed or contains invalid parameters - `401` — Unauthorized - Authentication credentials are missing or invalid - `403` — Forbidden - You don't have permission to access this resource - `429` — Too Many Requests - You have exceeded the rate limit - `500` — Internal Server Error - An unexpected error occurred on the server ## Changes - **2025-09-12** `638a8df09bf4` — 1 breaking - the `items/accepted_payment_methods` response's property type changed from `string` to no type for status `200` - **2025-08-14** `ca9b053c4373` — 4 info - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `429` - added the non-success response with the status `500` [Change history](https://skmtc.dev/servicem8/apis/servicem8-api/changes/vendor.json/get.md) --- [API](https://skmtc.dev/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.dev/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/revisions/5793f2e4c841/schema)