---
title: UpnpService type | Wartiva GraphQL API
description: UPnP service is a logical functional unit. Smallest units of control. Exposes actions and models the state of a physical device with state variables.
url: https://wartiva.com/api-docs/types/upnp-service.html
updated: 2026-10-07
---

Networks, devices, and sensors · GraphQL type

# `UpnpService` type

UPnP service is a logical functional unit. Smallest units of control. Exposes actions and models the state of a physical device with state variables.

## Fields

| Field Name | Description |
|---|---|
| `serviceType` - [`String!`](https://wartiva.com/api-docs/types/string.html) | Sent once for each device, root or embedded, where serviceType and ver are defined by UPnP Forum working committee e.g. "urn:schemas-upnp-org:service:Layer3Forwarding:1". |
| `serviceId` - [`String!`](https://wartiva.com/api-docs/types/string.html) | Service identifier. Shall be unique within this device description e.g. "urn:upnp-org:serviceId:L3Forwarding1". |
| `scpdUrl` - [`String`](https://wartiva.com/api-docs/types/string.html) | URL for service description. Shall be relative to the URL at which the device description is located in accordance with clause 5 of RFC 3986. Specified by UPnP vendor. |
| `controlUrl` - [`String`](https://wartiva.com/api-docs/types/string.html) | URL for control. Shall be relative to the URL at which the device description is located in accordance with clause 5 of RFC 3986. Specified by UPnP vendor. |
| `eventSubUrl` - [`String`](https://wartiva.com/api-docs/types/string.html) | URL for eventing (see clause 4, “Eventing”). shall be relative to the URL at which the device description is located in accordance with clause 5 of RFC 3986. Shall be unique within the device; any two services shall not have the same URL for eventing. If the service has no event variables, this element shall be present but shall be empty. Specified by UPnP vendor. |

## Used by

- [`UpnpDevice`](https://wartiva.com/api-docs/types/upnp-device.html) type: Universal Plug and Play (UPnP) logical device advertises its presence and the services it provides on the network(s).

## Example

### Example

```json
{
  "serviceType": "abc123",
  "serviceId": "xyz789",
  "scpdUrl": "xyz789",
  "controlUrl": "xyz789",
  "eventSubUrl": "xyz789"
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt