---
title: "Get a custom object record"
method: GET
path: "/custom-object-records/{recordId}"
tags: ["Settings"]
---

# Get a custom object record

`GET /custom-object-records/{recordId}`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/custom-object-records/{recordId}`
- Auth: HTTP bearer

Gets one catalog record, including archived records. Requires `settings.read`.

## Path parameters

- `recordId` string, required

## Response `200`

Catalog record.

- CustomObjectRecord
  - `id` string, required
  - `object` 'custom_object_record', required
  - `typeId` string, required
  - `name` string, required
  - `slug` string, nullable, required: URL-safe identifier, unique within the collection. Changing it keeps the previous value reserved. Generated from the name on create; renaming keeps it. Null only on records saved before slugs existed.
  - `logoUrl` string, uri, nullable, required: Deprecated: use the collection's logo image field (`logoFieldKey` on the type). A legacy logo URL stored on older records.
  - `externalId` string, nullable, required
  - `values` object, required
  - `archived` boolean, required
  - `createdAt` string, date-time, required

## Other responses

- `404`: Catalog resource not found.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `404` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/custom-object-records/:recordId/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)