> ## Documentation Index
> Fetch the complete documentation index at: https://www.orwel.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

> [!NOTE]
>
> Requires an [API key](https://www.orwel.io/docs/authentication.md) (`orwel_sk_`) with the `conversions:read` scope.

A **conversion** is each time someone completes a goal you track with [`orwel.conversion()`](https://www.orwel.io/docs/sdk/conversions): 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}`](https://www.orwel.io/docs/api-reference/leads/get) |

## Query Parameters

**limit** `integer` (default: 50)

Maximum number of results to return (max: 100)

**offset** `integer` (default: 0)

Number of results to skip for pagination

**lead\_id** `string`

Only the conversions of this lead (UUID)

**identity\_id** `string`

Only the conversions of this identity (UUID)

**code** `string`

Filter by conversion code (for example `generate_lead`)

**source** `string`

Filter by the source that sent the conversion

**is\_test** `boolean`

`true` for conversions sent with the development key, `false` for production ones. Leave it out to get both.

**created\_after** `string`

Only conversions created at or after this ISO 8601 date

**created\_before** `string`

Only conversions created at or before this ISO 8601 date

## Response

**data** `array`

Array of conversion objects

**Conversion Object**

**id** `string`

Unique identifier of the conversion

**lead\_id** `string`

Lead (person) this conversion belongs to

**identity\_id** `string`

Visitor identity of the person

**visitor\_id** `string`

Visitor that converted

**session\_id** `string`

Session in which the conversion happened

**company\_id** `string`

Enriched company, when Orwel found one

**code** `string`

Conversion code

**source** `string`

What sent the conversion (for example the SDK version)

**properties** `object`

Data sent with the conversion: form fields, UTM and attribution

**location** `object`

Page where it happened: `url`, `path`, `search`, `hostname`

**is\_test** `boolean`

Whether it was sent with the development key

**created\_at** `string`

ISO 8601 timestamp of the conversion

**pagination** `object`

Pagination information

```bash cURL theme={null}
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"
```

```javascript JavaScript theme={null}
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
```

```python Python theme={null}
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())
```

```json Response theme={null}
{
  "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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.