---
title: Location type | Wartiva GraphQL API
description: A physical place identified by its global plus code (Open Location Code), with a street address resolved by reverse geocoding.
url: https://wartiva.com/api-docs/types/location.html
updated: 2026-10-07
---

Location · GraphQL type

# `Location` type

A physical place identified by its global plus code (Open Location Code), with a street address resolved by reverse geocoding. Observed [PositionSeen](https://wartiva.com/api-docs/types/position-seen.html) coordinates resolve to a Location, and many nearby positions can share one place. The address can be corrected by a user, and the correction then takes precedence over the geocoded result.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The Location's unique identifier on the security graph. |
| `orgId` - [`OrganizationId!`](https://wartiva.com/api-docs/types/organization-id.html) | Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to. |
| `seen` - [`SeenOnline!`](https://wartiva.com/api-docs/types/seen-online.html) | Describes when this Endpoint was seen online. |
| `objectType` - [`GraphObjectType!`](https://wartiva.com/api-docs/types/graph-object-type.html) | The type of this graph object. |
| `objectTypeLabel` - [`String!`](https://wartiva.com/api-docs/types/string.html) | A localized label describing the object type. |
| `displayName` - [`String!`](https://wartiva.com/api-docs/types/string.html) | A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object. |
| `firstSeen` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time this object was first seen. |
| `lastSeen` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time this object was last seen. |
| `createdAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was created in the security graph. |
| `updatedAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was last mutated in the security graph. |
| `snapshotInfo` - [`GraphObjectSnapshotInfo!`](https://wartiva.com/api-docs/types/graph-object-snapshot-info.html) | Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed. |
| `address` - [`PhysicalAddress!`](https://wartiva.com/api-docs/types/physical-address.html) | The physical address of this Location. |
| `addressCorrected` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | True if the address has been corrected by the user. |
| `plusCodeGlobalCode` - [`PlusCodeGlobalCode!`](https://wartiva.com/api-docs/types/plus-code-global-code.html) | A unique identifier of this Location in Open Location Code format, also known as a global plus code. |
| `positionsSeen` - [`PositionSeenConnection!`](https://wartiva.com/api-docs/types/position-seen-connection.html) | Positions that have been associated with this Location. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `findings` - [`FindingsPayload!`](https://wartiva.com/api-docs/types/findings-payload.html) | Policy findings for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issues` - [`IssuesPayload!`](https://wartiva.com/api-docs/types/issues-payload.html) | Policy issues for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issuesSummary` - [`IssuesSummary!`](https://wartiva.com/api-docs/types/issues-summary.html) | Summary of the active policy issues currently open on this object, broken down by severity. |

## Returned by

- [`location`](https://wartiva.com/api-docs/queries/location.html) query: Retrieves a Location by its graph object id: a physical place, identified by its global plus code and street address, that observed positions…

## Used by

- [`PositionSeen`](https://wartiva.com/api-docs/types/position-seen.html) type: A geographic coordinate (latitude and longitude) where a managed Endpoint was observed, and the times it was seen there.
- [`GraphObjectType`](https://wartiva.com/api-docs/types/graph-object-type.html) enum: An enumeration of the different types of security graph objects.
- [`GraphObjectTypeCategory`](https://wartiva.com/api-docs/types/graph-object-type-category.html) enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
- [`LocationPayload`](https://wartiva.com/api-docs/types/location-payload.html) type: Payload wrapper for a single Location result.
- [`SensorFilterLocations`](https://wartiva.com/api-docs/types/sensor-filter-locations.html) type: A filter considering the geographic location when determining if any sensors enabled by this scope apply to a Device or Network.

## Example

### Example

```json
{
  "id": "4",
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "address": PhysicalAddress,
  "addressCorrected": false,
  "plusCodeGlobalCode": "796RWF8Q+WF",
  "positionsSeen": PositionSeenConnection,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}

```

---

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