---
title: "List Custom Entitys"
method: GET
path: "/custom_entity"
tags: ["Custom Entity"]
---

# List Custom Entitys

`GET /custom_entity`

Retrieve a list of custom entitys

## Query parameters

- `id` string
- `created_at` string
- `updated_at` string
- `organisation_id` string
- `custom_entity_definition_id` string
- `contact_id` string
- `external_id` string
- `data` string
- `select` string
- `order` string
- `offset` string
- `limit` string

## Headers

- `Range` string
- `Range-Unit` string

## Response `200`

OK

- CustomEntity[]
  - `id` string, uuid — Entity ID
  - `created_at` string, timestamp with time zone — Creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `custom_entity_definition_id` string, uuid — Custom entity definition ID
  - `contact_id` string, uuid — Contact ID
  - `external_id` string, text, nullable — External ID
  - `data` object — Entity data matching the custom entity definition schema

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)