Skip to main content
GET
/
api
/
v1
/
external
/
companies
/
{companyId}
/
entities
/
{entityType}
/
{entityId}
Get Entity
curl --request GET \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/entities/{entityType}/{entityId} \
  --header 'Authorization: <api-key>'
{
  "id": "550e8400-e29b-41d4-a716-446655440301",
  "fieldModelV1Data": {
    "exposureName": "Acme Corp HQ"
  },
  "createdAt": 1736937000,
  "createdBy": "google-oauth2|123456789",
  "updatedAt": 1736937000,
  "updatedBy": null,
  "createdByName": "Jane Adjuster",
  "updatedByName": null
}

Authorizations

​
Authorization
string
header
required

API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.

Path Parameters

​
companyId
string<uuid>
required

Company identifier

​
entityType
enum<string>
required

Field Model V1 entity type (lowercase kebab-case URL slug). One of the six CRUD entity types: event, exposure, quote, submission, person, organization. policy is NOT valid here — Policy has no generic CRUD (its writes go through the policy transaction endpoints), though it does have a read-only /configuration schema.

Available options:
event,
exposure,
quote,
submission,
person,
organization
​
entityId
string<uuid>
required

Entity identifier

Response

Entity details

The generic shape returned by unified entity get and list endpoints. All entity-specific field values live inside fieldModelV1Data (keyed by field referenceId); the envelope is identical for every entity type.

​
id
string<uuid>
required

Entity identifier

​
fieldModelV1Data
object
required

Field values keyed by referenceId. Includes calculated/auto-set values populated by the resolver (e.g. submissionNumber, quoteStatus) and join field IDs.

​
createdAt
integer<int64>
required

Creation time in epoch seconds.

​
createdBy
string | null
required

User ID of the creator, or null.

​
updatedAt
integer<int64>
required

Last update time in epoch seconds (equals createdAt if never updated).

​
updatedBy
string | null
required

User ID of the last updater, or null.

​
createdByName
string | null
required

Display name resolved from createdBy, or null.

​
updatedByName
string | null
required

Display name resolved from updatedBy, or null.