curl "https://api.orwel.io/api/v1/conversions?created_after=2026-10-01T00:00:00Z&is_test=false" \
-H "Authorization: Bearer orwel_sk_YOUR_KEY"
const res = await fetch(
'https://api.orwel.io/api/v1/conversions?is_test=false&limit=100',
{ headers: { Authorization: `Bearer ${process.env.ORWEL_API_KEY}` } }
)
const { data } = await res.json()
// Upsert by conversion id, group by lead_id
import os, requests
res = requests.get(
"https://api.orwel.io/api/v1/conversions",
headers={"Authorization": f"Bearer {os.environ['ORWEL_API_KEY']}"},
params={"is_test": "false", "limit": 100},
)
print(res.json())
{
"data": [
{
"id": "9682141a-58e4-4e6d-bf7f-afc7ca9449f4",
"lead_id": "a80f6b90-2218-496e-a5a7-6a76a706cd5a",
"identity_id": "8a376f26-60e4-4f3a-8d91-b6d6b74cf61a",
"visitor_id": "e5feb603-13f2-553a-ad5c-ae9b51483e04",
"session_id": "b0e6a095-afa0-4f8e-b986-b1f01a0f09f6",
"company_id": null,
"code": "generate_lead",
"source": "orwel-sdk-v1.7.2",
"properties": {
"email": "maria@company.com",
"form_id": "contact",
"utm": { "utm_source": "google" }
},
"location": {
"url": "https://www.example.com/contact",
"path": "/contact",
"search": "",
"hostname": "www.example.com"
},
"is_test": false,
"created_at": "2026-10-28T20:33:41.001Z"
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 114
}
}
Conversions
List Conversions
Every conversion of your workspace, newest first, with the lead, identity and session it belongs to. Use the id to sync conversions to a CRM or warehouse without duplicates.
GET
/
api
/
v1
/
conversions
curl "https://api.orwel.io/api/v1/conversions?created_after=2026-10-01T00:00:00Z&is_test=false" \
-H "Authorization: Bearer orwel_sk_YOUR_KEY"
const res = await fetch(
'https://api.orwel.io/api/v1/conversions?is_test=false&limit=100',
{ headers: { Authorization: `Bearer ${process.env.ORWEL_API_KEY}` } }
)
const { data } = await res.json()
// Upsert by conversion id, group by lead_id
import os, requests
res = requests.get(
"https://api.orwel.io/api/v1/conversions",
headers={"Authorization": f"Bearer {os.environ['ORWEL_API_KEY']}"},
params={"is_test": "false", "limit": 100},
)
print(res.json())
{
"data": [
{
"id": "9682141a-58e4-4e6d-bf7f-afc7ca9449f4",
"lead_id": "a80f6b90-2218-496e-a5a7-6a76a706cd5a",
"identity_id": "8a376f26-60e4-4f3a-8d91-b6d6b74cf61a",
"visitor_id": "e5feb603-13f2-553a-ad5c-ae9b51483e04",
"session_id": "b0e6a095-afa0-4f8e-b986-b1f01a0f09f6",
"company_id": null,
"code": "generate_lead",
"source": "orwel-sdk-v1.7.2",
"properties": {
"email": "maria@company.com",
"form_id": "contact",
"utm": { "utm_source": "google" }
},
"location": {
"url": "https://www.example.com/contact",
"path": "/contact",
"search": "",
"hostname": "www.example.com"
},
"is_test": false,
"created_at": "2026-10-28T20:33:41.001Z"
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 114
}
}
Requires an API key (
orwel_sk_) with the conversions:read scope.orwel.conversion(): a form, a signup, a booking. A lead is the person behind it. One person has one lead per workspace, so when they convert again Orwel adds a new conversion to the same lead instead of creating a second lead.
That gives you two stable keys for an external system:
| Field | Unique for | Use it to |
|---|---|---|
id | Each conversion | Upsert conversions (one row per form sent, signup, booking) |
lead_id | The person, in this workspace | Group conversions by lead, or join with GET /leads/{id} |
Query Parameters
integer
default:"50"
Maximum number of results to return (max: 100)
integer
default:"0"
Number of results to skip for pagination
string
Only the conversions of this lead (UUID)
string
Only the conversions of this identity (UUID)
string
Filter by conversion code (for example
generate_lead)string
Filter by the source that sent the conversion
boolean
true for conversions sent with the development key, false for production ones. Leave it out to get both.string
Only conversions created at or after this ISO 8601 date
string
Only conversions created at or before this ISO 8601 date
Response
array
Array of conversion objects
Show Conversion Object
Show Conversion Object
string
Unique identifier of the conversion
string
Lead (person) this conversion belongs to
string
Visitor identity of the person
string
Visitor that converted
string
Session in which the conversion happened
string
Enriched company, when Orwel found one
string
Conversion code
string
What sent the conversion (for example the SDK version)
object
Data sent with the conversion: form fields, UTM and attribution
object
Page where it happened:
url, path, search, hostnameboolean
Whether it was sent with the development key
string
ISO 8601 timestamp of the conversion
object
Pagination information
curl "https://api.orwel.io/api/v1/conversions?created_after=2026-10-01T00:00:00Z&is_test=false" \
-H "Authorization: Bearer orwel_sk_YOUR_KEY"
const res = await fetch(
'https://api.orwel.io/api/v1/conversions?is_test=false&limit=100',
{ headers: { Authorization: `Bearer ${process.env.ORWEL_API_KEY}` } }
)
const { data } = await res.json()
// Upsert by conversion id, group by lead_id
import os, requests
res = requests.get(
"https://api.orwel.io/api/v1/conversions",
headers={"Authorization": f"Bearer {os.environ['ORWEL_API_KEY']}"},
params={"is_test": "false", "limit": 100},
)
print(res.json())
{
"data": [
{
"id": "9682141a-58e4-4e6d-bf7f-afc7ca9449f4",
"lead_id": "a80f6b90-2218-496e-a5a7-6a76a706cd5a",
"identity_id": "8a376f26-60e4-4f3a-8d91-b6d6b74cf61a",
"visitor_id": "e5feb603-13f2-553a-ad5c-ae9b51483e04",
"session_id": "b0e6a095-afa0-4f8e-b986-b1f01a0f09f6",
"company_id": null,
"code": "generate_lead",
"source": "orwel-sdk-v1.7.2",
"properties": {
"email": "maria@company.com",
"form_id": "contact",
"utm": { "utm_source": "google" }
},
"location": {
"url": "https://www.example.com/contact",
"path": "/contact",
"search": "",
"hostname": "www.example.com"
},
"is_test": false,
"created_at": "2026-10-28T20:33:41.001Z"
}
],
"pagination": {
"limit": 50,
"offset": 0,
"total": 114
}
}