> This is the Markdown version of the page. For the complete Lattice Developers documentation index, fetch https://developer.anduril.com/llms.txt. Append .md to any page URL for its clean Markdown.

# List objects

GET https://example.developer.anduril.com/api/v1/objects

Lists objects in your environment. You can define a prefix to list a subset of your objects. If you do not set a prefix, Lattice returns all available objects. By default this endpoint will list local objects only.

Reference: https://developer.anduril.com/reference/rest/objects/list-objects

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `prefix` (string, optional) — Filters the objects based on the specified prefix path. If no path is specified, all objects are returned.
- `sinceTimestamp` (datetime, optional) — Filters out objects whose `last_updated_at` is earlier than this timestamp. `last_updated_at` records when an object arrived on the node that holds it, so this filter selects objects that arrived since the given time. It is not the time the object was authored: a copy that reaches a node later carries the later arrival time.
- `pageToken` (string, optional) — Opaque cursor for continuing the same list request. Start a new listing without the previous cursor if any query parameter or listing scope changes.
- `allObjectsInMesh` (boolean, optional) — Lists objects across all environment nodes in a Lattice Mesh. When false or unset, only objects held by the local node are returned.
- `maxPageSize` (integer, optional) — Sets the maximum number of items that should be returned on a single page.

## Response

### 200

Successful operation

- `path_metadatas` (list of object, required)
  - `content_identifier` (object, required)
    - `path` (string, required) — A valid path must not contain the following: - Spaces or Tabs - Special characters other than underscore (_), dash (-), period (.) and slash (/) - Non-ASCII characters such as accents or symbols Paths must not start with a leading space.
    - `checksum` (string, required) — The SHA-256 checksum of this object.
  - `size_bytes` (uint64, required)
  - `last_updated_at` (datetime, required) — When this object arrived on the node that holds it, according to that node's clock. Because an object is never modified in place, this is effectively the time the object was created on that node. The value is local to the node holding the object and may differ when the same object is held on multiple nodes. It is not propagated from the node where the object originated.
  - `expiry_time` (datetime, optional)
- `next_page_token` (string, optional)

## Errors

### 400 Bad Request Error

Bad request

- `code` (string, required)
- `message` (string, required)

### 401 Unauthorized Error

Unauthorized to access resource

- `code` (string, required)
- `message` (string, required)

### 500 Internal Server Error

Internal server error

- `code` (string, required)
- `message` (string, required)

## Examples

**Response**

```json
{
  "path_metadatas": [
    {
      "content_identifier": {
        "path": "string",
        "checksum": "string"
      },
      "size_bytes": 1,
      "last_updated_at": "2024-01-15T09:30:00Z",
      "expiry_time": "2024-01-15T09:30:00Z"
    }
  ],
  "next_page_token": "string"
}
```