--- title: PositionSeen type | Wartiva GraphQL API description: A geographic coordinate (latitude and longitude) where a managed Endpoint was observed, and the times it was seen there. url: https://wartiva.com/api-docs/types/position-seen.html updated: 2026-10-07 --- Location · GraphQL type # `PositionSeen` type A geographic coordinate (latitude and longitude) where a managed [Endpoint](https://wartiva.com/api-docs/types/endpoint.html) was observed, and the times it was seen there. Endpoints and [Device](https://wartiva.com/api-docs/types/device.html) objects link to the positions where they were seen, last seen, and primarily located, a [Network](https://wartiva.com/api-docs/types/network.html) links to its primary position, and a position can resolve to a [Location](https://wartiva.com/api-docs/types/location.html) with a street address. ## Fields | Field Name | Description | |---|---| | `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The PositionSeen'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. | | `position` - [`Position!`](https://wartiva.com/api-docs/types/position.html) | The coordinates of this position. | | `location` - [`Location`](https://wartiva.com/api-docs/types/location.html) | If this position is associated with a known Location. | | `networks` - [`NetworkConnection!`](https://wartiva.com/api-docs/types/network-connection.html) | Networks located at this position. | | 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. | | `devices` - [`DeviceConnection!`](https://wartiva.com/api-docs/types/device-connection.html) | Devices last located at this position. | | 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. | | `primaryLocationOfDevices` - [`DeviceConnection!`](https://wartiva.com/api-docs/types/device-connection.html) | [Device](https://wartiva.com/api-docs/types/device.html) objects primarily located at this position (where they spend most of their time). | | 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. | | `devicesSeenAt` - [`DeviceConnection!`](https://wartiva.com/api-docs/types/device-connection.html) | Historical sightings of [Device](https://wartiva.com/api-docs/types/device.html) objects at this position. Each edge records when the device was observed here; pass timeRange to constrain the window. When timeRange is null the last 30 days will be returned. | | 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. `timeRange` - [`DateTimeRangeInput`](https://wartiva.com/api-docs/types/date-time-range-input.html) Restrict edges to a date/time range. `includeSeen` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) Include the per-edge seen series in the response. | | `endpoints` - [`EndpointConnection!`](https://wartiva.com/api-docs/types/endpoint-connection.html) | Endpoints last seen at this position. | | 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. | | `primaryLocationOfEndpoints` - [`EndpointConnection!`](https://wartiva.com/api-docs/types/endpoint-connection.html) | [Endpoint](https://wartiva.com/api-docs/types/endpoint.html) objects primarily located at this position (where they spend most of their time). | | 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. | | `endpointsSeenAt` - [`EndpointConnection!`](https://wartiva.com/api-docs/types/endpoint-connection.html) | Historical sightings of [Endpoint](https://wartiva.com/api-docs/types/endpoint.html) objects at this position. Each edge records when the endpoint was observed here; pass timeRange to constrain the window. When timeRange is null the last 30 days will be returned. | | 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. `timeRange` - [`DateTimeRangeInput`](https://wartiva.com/api-docs/types/date-time-range-input.html) Restrict edges to a date/time range. `includeSeen` - [`Boolean`](https://wartiva.com/api-docs/types/boolean.html) Include the per-edge seen series in the response. | | `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 - [`positionSeen`](https://wartiva.com/api-docs/queries/position-seen.html) query: Retrieves a PositionSeen by its graph object id: a geographic coordinate where endpoints, and the devices and networks they see, were observed, with… ## Used by - [`Device`](https://wartiva.com/api-docs/types/device.html) type: A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as… - [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) type: A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization. - [`Network`](https://wartiva.com/api-docs/types/network.html) type: An IP network (subnet) that a managed Endpoint has been attached to, identified by its address range in CIDR notation and, for networks outside a… - [`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. - [`PositionSeenConnection`](https://wartiva.com/api-docs/types/position-seen-connection.html) type: Collection payload for PositionSeen edges with total count. - [`PositionSeenEdge`](https://wartiva.com/api-docs/types/position-seen-edge.html) type: Edge payload for a PositionSeen with optional seen data. - [`PositionSeenPayload`](https://wartiva.com/api-docs/types/position-seen-payload.html) type: Payload wrapper for a single PositionSeen result. - [`RuleApplyToOptionKey`](https://wartiva.com/api-docs/types/rule-apply-to-option-key.html) enum: Attribute keys that further scope which objects a rule applies to, in addition to its applyTo object type. ## Related types - [`Device`](https://wartiva.com/api-docs/types/device.html) A physical or virtual device that does not run the Wartiva endpoint application but is visible on the network to a managed Endpoint, such as… - [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization. - [`Location`](https://wartiva.com/api-docs/types/location.html) A physical place identified by its global plus code (Open Location Code), with a street address resolved by reverse geocoding. ## Example ### Example ```json { "id": "4", "orgId": "615f3b3b28284380e28a7342", "seen": SeenOnline, "objectType": "ACCOUNT_POLICY", "objectTypeLabel": "xyz789", "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, "position": Position, "location": Location, "networks": NetworkConnection, "devices": DeviceConnection, "primaryLocationOfDevices": DeviceConnection, "devicesSeenAt": DeviceConnection, "endpoints": EndpointConnection, "primaryLocationOfEndpoints": EndpointConnection, "endpointsSeenAt": EndpointConnection, "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