vendure/docs/content/graphql-api/shop/queries.md

---

title: "Queries" weight: 1 date: 2023-06-21T06:23:30.799Z showtoc: true

generated: true

Queries

activeChannel

The active Channel

{{% gql-fields %}}

• activeChannel: Channel! {{% /gql-fields %}}

activeCustomer

The active Customer

{{% gql-fields %}}

• activeCustomer: Customer {{% /gql-fields %}}

activeOrder

The active Order. Will be null until an Order is created via addItemToOrder. Once an Order reaches the state of PaymentAuthorized or PaymentSettled, then that Order is no longer considered "active" and this query will once again return null.

{{% gql-fields %}}

• activeOrder: Order {{% /gql-fields %}}

availableCountries

An array of supported Countries

{{% gql-fields %}}

• availableCountries: [Country!]! {{% /gql-fields %}}

collection

Returns a Collection either by its id or slug. If neither 'id' nor 'slug' is specified, an error will result.

{{% gql-fields %}}

• collection(id: ID, slug: String): Collection {{% /gql-fields %}}

collections

A list of Collections available to the shop

{{% gql-fields %}}

• collections(options: CollectionListOptions): CollectionList! {{% /gql-fields %}}

eligiblePaymentMethods

Returns a list of payment methods and their eligibility based on the current active Order

{{% gql-fields %}}

• eligiblePaymentMethods: [PaymentMethodQuote!]! {{% /gql-fields %}}

eligibleShippingMethods

Returns a list of eligible shipping methods based on the current active Order

{{% gql-fields %}}

• eligibleShippingMethods: [ShippingMethodQuote!]! {{% /gql-fields %}}

facet

Returns a Facet by its id

{{% gql-fields %}}

• facet(id: ID!): Facet {{% /gql-fields %}}

facets

A list of Facets available to the shop

{{% gql-fields %}}

• facets(options: FacetListOptions): FacetList! {{% /gql-fields %}}

me

Returns information about the current authenticated User

{{% gql-fields %}}

• me: CurrentUser {{% /gql-fields %}}

nextOrderStates

Returns the possible next states that the activeOrder can transition to

{{% gql-fields %}}

• nextOrderStates: [String!]! {{% /gql-fields %}}

order

Returns an Order based on the id. Note that in the Shop API, only orders belonging to the currently-authenticated User may be queried.

{{% gql-fields %}}

• order(id: ID!): Order {{% /gql-fields %}}

orderByCode

Returns an Order based on the order code. For guest Orders (i.e. Orders placed by non-authenticated Customers) this query will only return the Order within 2 hours of the Order being placed. This allows an Order confirmation screen to be shown immediately after completion of a guest checkout, yet prevents security risks of allowing general anonymous access to Order data.

{{% gql-fields %}}

• orderByCode(code: String!): Order {{% /gql-fields %}}

product

Get a Product either by id or slug. If neither 'id' nor 'slug' is specified, an error will result.

{{% gql-fields %}}

• product(id: ID, slug: String): Product {{% /gql-fields %}}

products

Get a list of Products

{{% gql-fields %}}

• products(options: ProductListOptions): ProductList! {{% /gql-fields %}}

search

Search Products based on the criteria set by the SearchInput

{{% gql-fields %}}

• search(input: SearchInput!): SearchResponse! {{% /gql-fields %}}