---
title: "List a team's custom objects"
method: GET
path: "/api/v1/teams/{team}/custom_objects"
---

# List a team's custom objects

`GET /api/v1/teams/{team}/custom_objects`

Returns a paginated list of custom objects owned by the specified team,
filtered to a single schema type. Results are ordered by creation time
descending unless `query` is provided, in which case they are ordered by
full-text relevance score descending.

Use `limit` and `offset` for page-based pagination. Use `row_key` or
`sort_key` to narrow results to objects matching those index values.
Full-text search via `query` operates only against the fields configured
as `search_fields` on the schema.

The authenticated user must be a member of the team with sufficient
access. Returns 404 if the team is not found, the caller lacks access,
or `type` does not match a registered schema for the team's organization.

## Path parameters

- `team` string, required

## Query parameters

- `row_key` string
- `sort_key` string
- `query` string
- `limit` integer
- `offset` integer
- `type` string, required

## Response `200`

Successful response

- object — Paginated list of custom objects owned by the team.
  - `data` object[], required — Array of custom object records for the current page.
    - `created_at` string, date-time — When the custom object was created (ISO 8601).
    - `fields` object — Map of field names to their current values as defined by the object's schema type.
    - `id` string, required — Unique identifier for the custom object (`cobj_...`).
    - `org` string — ID of the organization this object belongs to (`org_...`).
    - `row_key` string — An optional stable key used to identify this object by a caller-controlled string rather than its generated ID. `null` if not set.
    - `sandbox` string — ID of the sandbox environment this object is scoped to (`dsb_...`). `null` for production objects.
    - `schema_type` string — The lookup key of the schema type that defines this object's field structure. `null` if the schema type has not been set.
    - `team` string — ID of the team that owns this object (`tem_...`). `null` if the object is not team-scoped.
    - `updated_at` string, date-time — When the custom object was last modified (ISO 8601). `null` if the object has never been updated after creation.
    - `user` string — ID of the user that owns this object (`usr_...`). `null` if the object is not user-scoped.
    - `version` integer — Optimistic concurrency version of the object. Increments with each successful update; pass this value in write operations to detect conflicting changes.
  - `meta` object — Pagination metadata for the response.

## Other responses

- `401` — Unauthorized
- `404` — Team not found or schema type not found

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)