---
id: locations
title: locations
---

Lists locations, including discarded-record tombstones. Requires the catalog:read scope.

```graphql
locations(
  after: String
  first: Int = 100
  updatedSince: DateTime
): LocationCollection!
```

### Arguments

#### [`locations.after`](#after) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#after}

Return records after this opaque cursor from the previous page.

#### [`locations.first`](#first) · [`Int`](/docs/developers/api-reference/management/v1/types/scalars/int) **scalar** {#first}

Number of records to return. Values are limited to a maximum of 100.

#### [`locations.updatedSince`](#updated-since) · [`DateTime`](/docs/developers/api-reference/management/v1/types/scalars/date-time) **scalar** {#updated-since}

Include records updated at or after this timestamp (inclusive).

### Type

#### [`LocationCollection`](/docs/developers/api-reference/management/v1/types/objects/location-collection) **object**

One deterministic page from the Management v1 change feed.