--- title: "Create multiple vendors" method: POST path: "/v3/vendors/bulk" tags: ["vendors"] --- # Create multiple vendors `POST /v3/vendors/bulk` Create multiple vendors with one API request. You can create up to 20 vendors with one `POST /v3/vendors/bulk` request. In your bulk vendor creation request, all your vendors must be successfully created for a successful response. If any vendor creation is not successful, the entire request fails and none of the vendors in the request are created. ### Requirements for enabling vendor payments Vendor address details are required for paying a vendor by check or for inviting the vendor to join the BILL network. * `line1` * `city` * `zipOrPostalCode` * `country` * `payeeName` **Note**: A vendor can be enrolled to accept virtual card payments even without being connected in the BILL network. See [Virtual card FAQ](https://help.bill.com/direct/s/article/360021237411) in the BILL Help Center for more information. ### Requirements for enabling electronic payments to vendors Vendor bank account details are required for paying a vendor with electronic payment methods. `paymentInformation` details about bank accounts are required for adding a vendor bank account. * `payeeName` * `bankCountry` (for international vendors) * `paymentCurrency` (for international vendors) * `nameOnAccount` * `accountNumber` * `routingNumber` (empty for an IBAN `accountNumber`) * `type` (for international vendors) `regulatoryFields` and `paymentPurpose` are additional required fields for enabling electronic payments to international vendors (not United States) in specific countries. **Note**: When you add a vendor bank account in the production environment, BILL requires 2 business days to complete a one-time verification of the bank account. To pay such a vendor, you must set a `processDate` that is 2 business days from the current date. See [Vendors](https://developer.bill.com/docs/ap-vendors) in the Guides section for more information, sample requests, and responses. ## Headers - `sessionId` string, nullable — API session ID generated with `/v3/login` - `devKey` string, nullable — Developer key generated with your BILL developer account ## Request body - VendorRequestDto[] - `name` string, required — Vendor name - `shortName` string — Vendor short name - `accountNumber` string — User account number set by the vendor. Set this field as the billing statement account number for vendor services such as utility or credit card bills. When you pay the vendor, this value appears on the check memo or electronic payment record. - `accountType` 'NONE' | 'BUSINESS' | 'PERSON' — Vendor account type - `email` string — Vendor email address - `phone` string — Vendor phone number - `address` object, required — Vendor address information - `line1` string - `line2` string - `city` string - `stateOrProvince` string - `zipOrPostalCode` string - `country` string - `paymentInformation` object — Vendor payment information - `payeeName` string, required — Vendor name for check and electronic payments. This field is overridden when you connect with a vendor in the BILL network. - `email` string — Vendor email address for receiving payment information. BILL uses the vendor `email` value when this payment `email` value is not set. - `bankAccount` object — Vendor bank account information - `nameOnAccount` string — Vendor bank account name - `accountNumber` string, required — Vendor bank account number. This field is required for enabling electronic payments to vendors. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set up vendor payment information for an international (not US) vendor. - `routingNumber` string — Vendor bank routing number. This field is required for enabling electronic payments to vendors. This field is empty for an IBAN `accountNumber`. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set up vendor payment information for an international (not US) vendor. - `type` 'CHECKING' | 'SAVINGS' — Vendor bank account type. This value is required for enabling electronic payments to international vendors (not United States) in specific countries. - `ownerType` 'BUSINESS' | 'PERSONAL' — Vendor bank account owner type - `regulatoryFields` NameValue[] — International bank account regulatory information. The `name` and `value` fields are required for each required bank account regulatory field. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set `regulatoryFields`. - `name` string — Name field - `value` string — Value field - `paymentCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD' — Payment currency. Three-letter abbreviation. This field is required for enabling electronic payments to vendors. See Country information for international payments in the BILL Help Center for more information. - `paymentPurpose` object — Payment purpose information for compliance with international payment rules of the vendor country. This one-time configuration is required for enabling electronic payments to international vendors. You can set `paymentPurpose` at the time of creating a vendor, updating vendor details, or creating a payment. **Note**: Set `paymentPurpose` only when it is required. Vendor countries, like Japan, do not require any payment purpose information. For such countries, setting `paymentPurpose` in your request results in an error response. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set `paymentPurpose`. - `text` string — Payment purpose text. This can be any user-defined text. If you set `text`, do not set `code`. - `code` object — Payment purpose code. If you set the `code` object, do not set `text`. - `name` string, required — Name - `additionalInfo` object — Vendor additional information - `taxId` string — Vendor tax ID. This value is required by the IRS for tax purposes. - `taxIdType` 'EIN' | 'SSN' — Vendor tax ID type - `track1099` boolean — Set as `true` if the vendor is eligible to receive an IRS form 1099 from the payer - `leadTimeInDays` integer — Vendor payment lead time in days - `combinePayments` boolean — Set as `true` to combine a bulk payment made to the vendor with `POST /v3/payments/bulk`. The default value is `true`. - `paymentTermId` string — BILL-generated ID of the payment term. Use payment terms to set the number of days that customers have to pay a vendor bill. - `companyName` string — Vendor business name. This value is required by the IRS for tax purposes. - `billCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD' — Bill currency. Three-letter abbreviation in the ISO 4217 format. The `billCurrency` value is the currency in which vendor bills are presented. The value is also the currency used in the invoices you receive from the vendor. **Note**: When the vendor bill currency is not `USD` (For example, `EUR`), the payment `processDate` for this vendor must be the next US business day. See Country information for international payments in the BILL Help Center for the list of countries that accept international payments with BILL. - `autoPay` object — Vendor auto-pay information. When you enable vendor auto-pay, BILL automatically pays the vendor when a bill is created for the vendor. **Note**: Enabling vendor `autoPay` requires an MFA-trusted API session. See [MFA setup](https://developer.bill.com/reference/setup) for information about the BILL MFA process. - `enabled` boolean — Set as `true` if the vendor auto-pay is enabled - `bankAccountId` string — BILL-generated ID of the organization bank account used to set up vendor auto-pay. The value begins with `bac`. - `createdBy` string — BILL-generated ID of the user that set up vendor auto-pay. The value begins with `006`. You can retrieve your user ID when you sign in with `/v3/login`. - `maxAmount` number — Maximum bill amount for which vendor auto-pay is enabled - `daysBeforeDueDate` integer — Number of days before the bill payment due date. For example, if `dueBeforeDueDate` is `3`, BILL submits the vendor payment 3 days before the bill payment due date. ## Response `201` Create multiple vendors response - BulkVendorResponseDto — Bulk vendor response. - `vendors` VendorResponseDto[] — List of vendors - `id` string — BILL-generated ID of the vendor. The value begins with `009`. - `archived` boolean, required — Set as `true` if the vendor is archived - `name` string — Vendor name - `shortName` string — Vendor short name - `accountNumber` string — User account number set by the vendor. When you pay the vendor, this value appears on the check memo or electronic payment record. - `accountType` 'NONE' | 'BUSINESS' | 'PERSON' | 'UNDEFINED' — Vendor account type - `email` string — Vendor email address - `phone` string — Vendor phone number. This field is overridden when you connect with a vendor in the BILL network. - `address` object — Vendor address information. This information is overridden when you connect with a vendor in the BILL network. - `line1` string, required — Address line 1 - `line2` string — Address line 2 - `city` string, required — Address city - `stateOrProvince` string — State or province - `zipOrPostalCode` string, required — Zip or postal code - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CV' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IN' | 'IO' | 'IQ' | 'IS' | 'IT' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'ST' | 'SV' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required — Country code (ISO2) - `countryName` string — Country name. - `paymentInformation` object — Vendor payment information - `payeeName` string, required — Vendor name for check and electronic payments. This field is overridden when you connect with a vendor in the BILL network. - `email` string — Vendor email address for receiving payment information. BILL uses the vendor `email` value when this payment `email` value is not set. - `lastPaymentDate` string — Last payment date - `payByType` 'CHECK' | 'ACH' | 'RPPS' | 'OFFLINE' | 'INTERNATIONAL_E_PAYMENT' | 'VIRTUAL_CARD' | 'WALLET' | 'UNDEFINED' — Payment method for BILL payments - `payBySubType` 'NONE' | 'WIRE' | 'IACH' | 'LOCAL' | 'MULTIPLE' | 'ACH' | 'UNDEFINED' — Payment delivery method for international payments. - `transferMethod` 'WIRE' | 'LOCAL' | 'UNDEFINED' — Default payment delivery method for international payments. This field is set when `payBySubType` is set as `MULTIPLE`. * `LOCAL`: Funds transferred with the vendor country's domestic payment network * `WIRE`: Funds transferred with bank-operated networks (For example, SWIFT) - `virtualCard` object — Virtual card information. **Note**: A vendor can be enrolled to accept virtual card payments even without being connected in the BILL network. See [Virtual card FAQ](https://help.bill.com/direct/s/article/360021237411) in the BILL Help Center for more information. - `status` string - `remitEmail` string - `enrollDate` string, date-time - `declineDate` string, date-time - `alternatePayByType` string - `bankAccount` object — Vendor bank account information. This information is overridden when you connect with a vendor in the BILL network. - `nameOnAccount` string — Vendor bank account name - `accountNumber` string, required — Vendor bank account number. This field is required for enabling electronic payments to vendors. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set up vendor payment information for an international (not US) vendor. - `routingNumber` string — Vendor bank routing number. This field is required for enabling electronic payments to vendors. This field is empty for an IBAN `accountNumber`. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set up vendor payment information for an international (not US) vendor. - `type` 'CHECKING' | 'SAVINGS' — Vendor bank account type. This value is required for enabling electronic payments to international vendors (not United States) in specific countries. - `ownerType` 'BUSINESS' | 'PERSONAL' — Vendor bank account owner type - `regulatoryFields` NameValue[] — International bank account regulatory information. The `name` and `value` fields are required for each required bank account regulatory field. See [Create an international vendor](https://developer.bill.com/docs/creating-an-international-vendor) for more information on how to set `regulatoryFields`. - `name` string — Name field - `value` string — Value field - `paymentCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD' — Payment currency. Three-letter abbreviation. This field is required for enabling electronic payments to vendors. See Country information for international payments in the BILL Help Center for more information. - `bankInfo` object — Vendor bank account branch information - `swiftBIC` string — SWIFT code - `branchName` string — Branch name - `countryISO` string — Country ISO code - `nationalBankCode` string — National bank code - `institutionName` string — Bank institution name - `primaryKey` string — Primary key - `address` object — Bank address - `line1` string — Address line 1 - `line2` string — Address line 2 - `city` string — City - `stateOrProvince` string — State or province - `zipOrPostalCode` string — Zip or postal code - `country` string — Country - `status` 'NOT_VERIFIED' | 'VERIFIED' | 'PENDING' | 'BLOCKED' | 'EXPIRED' | 'INVALID' | 'UNDEFINED' — Vendor bank account status. - `paymentPurpose` object — Payment purpose information - `text` string — Payment purpose text - `code` object — Payment purpose code - `name` string — Name - `value` string — Value - `additionalInfo` object — Vendor additional information - `taxId` string — Vendor tax ID. This value is required by the IRS for tax purposes. - `taxIdType` 'EIN' | 'SSN' | 'UNDEFINED' — Vendor tax ID type - `track1099` boolean — Set as `true` if the vendor is eligible to receive an IRS form 1099 from the payer - `leadTimeInDays` integer — Vendor payment lead time in days - `combinePayments` boolean — Set as `true` to combine a bulk payment made to the vendor with `POST /v3/payments/bulk`. The default value is `true`. - `paymentTermId` string — BILL-generated ID of the payment term. Use payment terms to set the number of days that customers have to pay a vendor bill. - `companyName` string — Vendor business name. This value is required by the IRS for tax purposes. - `rppsId` string — BILL-generated ID of the verified national vendor (if the vendor is a verified national vendor) - `bankAccountStatus` 'NO_ACCOUNT' | 'NO_NET_LINKED_ACCOUNT' | 'NET_LINKED_ACCOUNT' | 'UNDEFINED' — Vendor bank account status. - `recurringPayments` boolean — Set as `true` if the vendor has recurring payments enabled - `billCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD' — Bill currency - `createdTime` string, date-time — Created date and time - `updatedTime` string, date-time — Updated date and time - `balance` object — Vendor account balance information. When bills are created for the vendor, this information is updated. - `amount` number - `lastUpdatedDate` string, date-time - `autoPay` object — Vendor auto-pay information. When you enable vendor auto-pay, BILL automatically pays the vendor when a bill is created for the vendor. - `enabled` boolean — Set as `true` if the vendor auto-pay is enabled - `bankAccountId` string — BILL-generated ID of the organization bank account used to set up vendor auto-pay. The value begins with `bac`. - `createdBy` string — BILL-generated ID of the user that set up vendor auto-pay. The value begins with `006`. You can retrieve your user ID when you sign in with `/v3/login`. - `maxAmount` number — Maximum bill amount for which vendor auto-pay is enabled - `daysBeforeDueDate` integer — Number of days before the bill payment due date. For example, if `dueBeforeDueDate` is `3`, BILL submits the vendor payment 3 days before the bill payment due date. - `networkStatus` 'NOT_CONNECTED' | 'PENDING' | 'CONNECTED' | 'CONNECTED_RPPS' — Network connection status. This field appears in the response only when a network connection status is available for the vendor. - `paymentNetworkId` string — Vendor Payment Network ID (PNI). Each vendor with a BILL account is assigned a unique PNI. ## Other responses - `4XX` — List of errors. - `5XX` — List of errors. --- [API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)