> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetSupplierById

> Delivers the curated detail of a single supplier by its id, regardless of active state.



**query** `GetSupplierById(supplierId: ID!): SupplierDetail!`

## Arguments

**`supplierId`**: `ID!` (required)

## Returns

`SupplierDetail!`

**`id`**: `ID!`

Unique identifier of the supplier.

---

**`supplierNumber`**: `String`

Supplier number (free-text supplier identifier held at the merchant).

---

**`companyName`**: `String`

Company name of the supplier.

---

**`status`**: `String`

Free-text status of the supplier.

---

**`canDropship`**: `Boolean!`

Indicates whether the supplier can be used for dropshipping.

---

**`currencyIso`**: `String`

ISO code of the supplier's currency.

---

**`isActive`**: `Boolean!`

Indicates whether the supplier is active.

---

**`address`**: `SupplierAddress!`

Postal address of the supplier.

---

**`contact`**: `SupplierContact`

Contact information of the supplier, or null when the supplier has no contact data.

---

**`languageIso`**: `String`

ISO code of the language assigned to the supplier.

---

**`supplierAccountNumber`**: `String`

The supplier's own customer number for the merchant ("Eigene Kd.-Nr."). A free-text value, not an identifier.

---

**`creditorNumber`**: `Int`

Creditor number of the supplier.

---

**`vatId`**: `String`

VAT identification number of the supplier.

---

**`freightCostAmount`**: `Decimal`

Freight cost charged by the supplier.

---

**`minimumOrderValueAmount`**: `Decimal`

Minimum order value required by the supplier.

---

**`smallQuantitySurchargeAmount`**: `Decimal`

Surcharge applied by the supplier for small quantities.

---

**`cashDiscountPercentage`**: `Decimal`

Cash discount percentage granted by the supplier.

---

**`cashDiscountDays`**: `Int`

Number of days within which the cash discount applies.

---

**`paymentTermInDays`**: `Int`

Payment term in days agreed with the supplier.

---

**`freeShippingThresholdAmount`**: `Decimal`

Order value from which the supplier ships free of charge.

---

**`deliveryTimeInDays`**: `Int`

Delivery time in days of the supplier.

---

**`website`**: `String`

Website URL of the supplier.

---

**`deliveryConditionNote`**: `String`

Note on the delivery conditions of the supplier.

---

**`comment`**: `String`

Free-text comment on the supplier.

---

**`createdAt`**: `DateTime`

Date and time when the supplier was created.

---

**`changedAt`**: `DateTime`

Date and time when the supplier was last changed.

---

**`defaultCompanyId`**: `ID`

Default own-company used for orders with this supplier, or null when unset.

---

**`defaultWarehouseId`**: `ID`

Default warehouse used for orders with this supplier, or null when unset.

---

**`isVatExempt`**: `Boolean!`

Indicates whether the supplier is exempt from VAT.

---

**`isExcludedFromPurchaseList`**: `Boolean!`

Indicates whether the supplier is excluded from the purchase list.

---

**`allowsDropshipCashOnDelivery`**: `Boolean!`

Indicates whether cash-on-delivery dropshipping is allowed for the supplier.

---

**`allowsDropshipFreeLineItems`**: `Boolean!`

Indicates whether free line items are allowed in dropshipping for the supplier.

---

**`vatFreePositionThresholdAmount`**: `Decimal`

Order value threshold above which line items are treated as VAT-free.