---
title: "Get a single trait definition"
method: GET
path: "/api/v1/ackdb/schemas/traits/{traitKey}"
tags: ["ackDB"]
---

# Get a single trait definition

`GET /api/v1/ackdb/schemas/traits/{traitKey}`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/schemas/traits/{traitKey}`
- Auth: HTTP bearer

Returns a specific trait definition by trait key. Use this for targeted lookups when you know the exact trait you need.

## Path parameters

- `traitKey` string, required

## Response `200`

Trait definition found

- object
  - `data` AckdbTraitDefinition, required: Trait definition. Like Salesforce custom fields - defines what computed fields exist. AI agents discover fields by listing these at runtime.
    - `traitKey` string, required: Unique within org. Convention: prefix with source name.
    - `valueType` 'string' | 'number' | 'boolean' | 'date' | 'string_array', required: Type system for trait validation and storage. Controls how trait values are validated on ingest and stored in the entity_traits table.
    - `source` string, required: Which source system this trait comes from.
    - `description` string, required: Human/AI-readable description. AI agents use this to understand the trait.
    - `allowedValues` unknown[], required: Optional enum constraint. Write API rejects values not in this list.
      - unknown
    - `scope` 'entity' | 'contact': Trait grain: entity (company) or contact. Defaults to "entity".
    - `createdAt` string, date-time, required

## Other responses

- `404`: Trait not found

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)