# Queries / Host

# Host

**Query**
## hostChanges — Returns [HostChangesConnection](/documentation/Objects/Host#HostChangesConnection)

**Scopes required:** see_host_changes

| Arguments | Type | Description |
| --- | --- | --- |
| connection | [ID!](/documentation/Types/UUID#UUID) | The connection to retrieve changes for |
| after | [Cursor](/documentation/Types/Cursor#Cursor) | Return the data after this cursor |

**Example Query**

```graphql
query GetHostChanges($connection: ID!) {
    hostChanges(connection: $connection) {
        __typename
    }
}

# Example variables
{
    "connection": "<CONNECTION>"
}
```

**Query**
## hostConnection — Returns [HostConnection](/documentation/Objects/Host#HostConnection)

**Scopes required:** see_host_connections

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

**Example Query**

```graphql
query GetHostConnection($id: ID!) {
    hostConnection(id: $id) {
        id,
        type,
        metadata,
        settings,
        credentials
    }
}

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

**Query**
## hostConnections — Returns [[HostConnection]](/documentation/Objects/Host#HostConnection)

**Scopes required:** see_host_connections

**Example Query**

```graphql
query GetHostConnections {
    hostConnections {
        id,
        type,
        metadata,
        settings,
        credentials
    }
}
```

**Query**
## hostHistory — Returns [HostHistoryConnection](/documentation/Objects/Host#HostHistoryConnection)

**Scopes required:** see_host_changes

| Arguments | Type | Description |
| --- | --- | --- |
| connection | [ID!](/documentation/Types/UUID#UUID) | The connection to retrieve the recent history of |
| after | [Cursor](/documentation/Types/Cursor#Cursor) | Return the data after this cursor |

**Example Query**

```graphql
query GetHostHistory($connection: ID!) {
    hostHistory(connection: $connection) {
        __typename
    }
}

# Example variables
{
    "connection": "<CONNECTION>"
}
```

**Query**
## hostMappedItems — Returns [[HostMappingProduct]](/documentation/Objects/Host#HostMappingProduct)

**Scopes required:** see_host_changes

| Arguments | Type | Description |
| --- | --- | --- |
| connection | [ID!](/documentation/Types/UUID#UUID) | The connection to retrieve changes for |

**Example Query**

```graphql
query GetHostMappedItems($connection: ID!) {
    hostMappedItems(connection: $connection) {
        __typename
    }
}

# Example variables
{
    "connection": "<CONNECTION>"
}
```

**Query**
## hostRelatedItems — Returns [[HostRelatedItem]](/documentation/Objects/Host#HostRelatedItem)

<p class="scopes"><span class="scope scope--none">No scope required</span></p>

| Arguments | Type | Description |
| --- | --- | --- |
| type | [HostAppliableTypeEnum!](/documentation/Enums/Host#HostAppliableTypeEnum) | The type of item you want to retrieve the related items for |
| id | [ID!](/documentation/Types/UUID#UUID) | Shopfront's ID of the item you wish to retrieve the related items |

**Example Query**

```graphql
query GetHostRelatedItems($type: HostAppliableTypeEnum!, $id: ID!) {
    hostRelatedItems(type: $type, id: $id) {
        id,
        name
    }
}

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

**Query**
## pendingHostIdentifiers — Returns [HostIdentifierChangesConnection](/documentation/Objects/Host#HostIdentifierChangesConnection)

**Scopes required:** see_host_changes

| Arguments | Type | Description |
| --- | --- | --- |
| connection | [ID!](/documentation/Types/UUID#UUID) | The connection to retrieve the pending identifier changes for |
| after | [Cursor](/documentation/Types/Cursor#Cursor) | Return the data after this cursor |
| type | [HostAppliableTypeEnum](/documentation/Enums/Host#HostAppliableTypeEnum) | The type of identifier changes to retrieve |
| filterMapped | *FilterMappedEnum* | Whether to filter out mapped identifiers |

**Example Query**

```graphql
query GetPendingHostIdentifiers($connection: ID!) {
    pendingHostIdentifiers(connection: $connection) {
        __typename
    }
}

# Example variables
{
    "connection": "<CONNECTION>"
}
```