# Queries / Suppliers

# Suppliers

**Query**
## supplier — Returns [Supplier](/documentation/Objects/Suppliers#Supplier)

**Scopes required:** see_suppliers

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the supplier to retrieve |

**Example Query**

```graphql
query GetSupplier($id: ID!) {
    supplier(id: $id) {
        id,
        name,
        parent,
        deleted,
        mdbId
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Query**
## suppliers — Returns [ConnectionType](/documentation/General/Connections) of [Supplier](/documentation/Objects/Suppliers#Supplier)

**Scopes required:** see_suppliers

### Sortable Fields
*Fields from [Supplier](/documentation/Objects/Suppliers#Supplier) that can be used to sort the connection items*

- name

| Arguments | Type | Description |
| --- | --- | --- |
| ids | [[ID!]](/documentation/Types/UUID#UUID) | The suppliers to bulk retrieve |
| mdbId | *Int* | The master database reference to search for |
| businessNumber | *String* | The business number to search for, note, Shopfront does not enforce any consistency for business numbers |

**Example Query**

```graphql
query GetSuppliers($ids: [ID!]) {
    suppliers(ids: $ids) {
        edges {
            node {
                id,
                name,
                parent,
                deleted,
                mdbId
            }
        },
        pageInfo {
            hasNextPage,
            endCursor
        }
    }
}

# Example variables
{
    "ids": [
        "<IDS>"
    ]
}
```