---
title: "POST /objects/{object_name}/records/find-unique"
method: POST
path: "/objects/{object_name}/records/find-unique"
tags: ["Object Records"]
---

# POST /objects/{object_name}/records/find-unique

`POST /objects/{object_name}/records/find-unique`

## Path parameters

- `object_name` string, required

## Request body

- FindUniqueRecordRequest — Request body for finding a unique record by attribute values.
  - `match` object, required — The attribute values to match against to find an existing record. At least one unique attribute must be included to ensure that at most one record is matched. Additional unique or non-unique attributes may also be included to refine the matching criteria.

## Response `200`

Response for a successful get operation.

- object — Response for a successful get operation.
  - `status` 'success', required
  - `data` object, nullable, required
    - `object` string, required — The API name of the object this record is an instance of.
    - `id` string, required — String UUIDv4 value.
    - `created_at` string, date-time, required — Date and time the record was created.
    - `updated_at` string, date-time, required — Date and time the record was last updated.
    - `attributes` object, required — Attribute values for the record. Each key is the API name of the attribute and each value is the corresponding attribute value for the record.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `404` — Response for any operation that results in a not found error.
- `500` — Response for any operation that results in an internal server error.

---

[API](https://skmtc.dev/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/revisions/2f145e6f6d7e/schema)