List Conversion Types
/conversion-types
List all active conversion types for your account. Use the conversion type id when creating conversion events.
Each type includes a fields array defining the custom metadata fields expected when creating events — use the field key values as keys in the event's metadata object.
Example
curl https://api.getnexor.ai/api/public/conversion-types \
-H "X-API-Key: nxr_live_your_api_key"
Responses
200 — Successful response
{
"success": true,
"conversion_types": [
{
"id": "123e4567-e89b-12d3-a456-426614174100",
"name": "Reserva",
"description": "Initial reservation deposit",
"category": "intermediary",
"currency": "USD",
"fields": [
{ "key": "property_unit", "label": "Property / Unit", "type": "text" },
{ "key": "broker", "label": "Broker", "type": "text" },
{ "key": "commission", "label": "Commission", "type": "number" }
],
"workflow_id": "uuid",
"master_workflow_id": null,
"created_at": "2026-01-10T08:00:00Z"
}
]
}
Response Fields — Conversion Type
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Unique conversion type identifier |
name | string | Conversion type name |
description | string | null | Conversion type description |
category | "intermediary" | "final" | Whether this is an intermediary milestone or a final business outcome |
currency | string | Default currency code for events of this type (e.g., USD, CLP, CLF) |
fields | array | Custom field definitions (see below) |
workflow_id | string (uuid) | null | Workflow this type is scoped to. Events inherit this automatically |
master_workflow_id | string (uuid) | null | Master workflow this type is scoped to. Events inherit this automatically |
created_at | string (date-time) | When the type was created |
Field Definition
| Field | Type | Description |
|---|---|---|
key | string | Machine-readable key used in the event's metadata object |
label | string | Human-readable label displayed in the UI |
type | "text" | "number" | Data type of the field value |
401 — Authentication error
See Authentication.