Suppliers Queries

Access supplier records, contact information, and linked products.

Supplier — Returns a single supplier by id

GraphQL

query GetSupplier($id: ID!) {
  Supplier(id: $id) {
    id
    label
    email
    phone
    active
    supplier_number
    website
    notes
    currency { id label }
    address { id city country }
  }
}

Suppliers — Returns a paginated list of suppliers with sorting and filters

GraphQL

query Suppliers(
  $where: QuerySuppliersWhereWhereConditions,
  $orderBy: [QuerySuppliersOrderByOrderByClause!],
  $search: String,
  $first: Int,
  $page: Int,
  $trashed: Trashed
) {
  Suppliers(
    where: $where,
    orderBy: $orderBy,
    search: $search,
    first: $first,
    page: $page,
    trashed: $trashed
  ) {
    paginatorInfo {
      total
      currentPage
    }
    data {
      id
      label
      email
      active
      phone
    }
  }
}

---

Available fields

Field	Type	Description
id	Int	Unique identifier for the supplier.
label	String	Supplier name or company name.
email	String	Primary contact email.
phone	String	Primary contact phone number.
active	Boolean	Activation status.
supplier_number	String	Internal reference number.
website	String	Website URL.
notes	String	Public notes for documents.
discount	Float	Default discount granted by this supplier.
language	String	Preferred language for communication.
currency	Currency	Procurement currency.
price_level	PriceLevel	Assigned price level for purchasing.
address	Address	Primary business address.
tax_codes	[TaxCode]	Applied tax configurations.
supplier_tags	[SupplierTag]	Labels for categorization.
employees	[Employee]	List of subsidiary contacts.
files	[File]	Attached documents.
integrations	[Integration]	Linked external platforms.
purchase_template	PdfTemplate	Template used for Purchase Orders.
purchase_receipt_template	PdfTemplate	Template used for Purchase Receipts.
created_at	DateTime	Creation time.
updated_at	DateTime	Last update time.
custom_fields	[EntityCustomField]	Custom fields for this entity.
variant_price	VariantPrice	Variant-specific price from this supplier. Requires variant_id argument.

VariantPrice

Field	Type	Description
id	ID	Unique identifier.
amount	Float	Price amount.
currency	Currency	Currency for this price.
variant	Variant	Linked product variant.
priceable_type	VariantPriceType	Type of priceable entity (Customer, Supplier, or PriceLevel).
priceable_id	Int	Priceable entity ID.
supplier_price_tiers	[SupplierVariantPriceTier]	Quantity-based price tiers.
created_at	DateTime	Creation time.
updated_at	DateTime	Last update time.

Example Query:

GraphQL

query GetSupplierVariantPrice($supplierId: ID!, $variantId: ID!) {
  Supplier(id: $supplierId) {
    id
    label
    variant_price(variant_id: $variantId) {
      id
      amount
      currency { code }
      supplier_price_tiers {
        from_quantity
        amount
      }
    }
  }
}

---

Data Types

VariantSupplierPivot

Field	Type	Description
supplier_sku	String	Supplier's SKU for this variant.

---

Filters

The following fields can be used in the where parameter:

id, label, email, phone, active, created_at, updated_at, country, city.

Example Filters:

Field	Example
active	{ "column": "ACTIVE", "operator": "EQ", "value": true }
label	{ "column": "LABEL", "operator": "LIKE", "value": "%Suppliers%" }
city	{ "column": "CITY", "operator": "EQ", "value": "Paris" }
trashed	Filter by trashed status. Accepts ALL, TRASHED, or NOT_TRASHED.

---

Sorting

You can sort results using the orderBy parameter:

• id
• label
• email
• phone
• active
• created_at
• updated_at

---

Enums

VariantPriceType

Value	Description
Customer	Customer entity.
Supplier	Supplier entity.
PriceLevel	Price level entity.