Shared Fields
Reference for all common field types used across multiple Logimeter API endpoints. These types appear in request bodies, response objects, and webhook payloads throughout the API.
Company
Identifies a partner company by name and reference. The name and reference must match a registered Partner Company Reference (PCR) in Logimeter.
{"name": "Cape Town Dealer", "reference": "dealer-cape-town-001"}
| Field | Type | Description |
|---|---|---|
| name | string | The company's display name as registered in Logimeter. |
| reference | string | The Partner Company Reference (PCR) — a unique identifier for this company in your system. |
Contact
References a registered partner contact — typically a sales agent or team member.
{"name": "Jane Smith", "reference": "agent-jane-001"}
| Field | Type | Description |
|---|---|---|
| name | string | The contact's full name. |
| reference | string | A unique identifier for this contact in your system. |
PhoneNumber
Phone numbers must be in E.164 format without the leading +. This means country code followed directly by the subscriber number with no spaces, hyphens, or brackets.
| Type | Format | Example | Notes |
|---|---|---|---|
| South African mobile | 27 + 9 digits | 27821234567 | Leading 0 replaced by country code 27. |
| South African landline | 27 + 9 digits | 27114567890 | E.g. 011 456 7890 becomes 27114567890. |
Never include +, spaces, or dashes. The v2 AutoConnect endpoint normalises South African numbers automatically (strips leading 0, prepends 27), but all other endpoints require pre-formatted numbers.
DateTime
All datetime values use ISO 8601 format with a timezone offset. The Logimeter platform operates in SAST (UTC+2).
"2026-01-15T09:30:00+02:00"
Always include the offset. Do not send naive (offset-free) datetimes. When storing datetimes in your system, preserve the offset or convert to UTC explicitly.
TimeField
Time values (e.g. for business hours) use 24-hour HH:MM:SS format.
| Example | Meaning |
|---|---|
| 08:30:00 | 8:30 AM |
| 17:00:00 | 5:00 PM |
| 00:00:00 | Midnight |
CallTermCallbackUrl
An HTTPS URL on your server that receives a POST request containing call data when a tracked call ends. On DNA and Connect endpoints, pass an array of URLs as call_term_callbacks (the singular call_term_callback field was removed). AutoConnect lead outcomes use autoconnect_callback_url on partner features instead.
- Must be an HTTPS URL accessible from the internet.
- Must respond with HTTP 200 within 10 seconds.
- Should return 200 immediately and process the payload asynchronously.
See Webhooks & Callbacks for the full payload specification and retry policy.
integration_active
Boolean flag on v2 Call Manager company, contact, call group, and business-hours resources. Controls whether the resource participates in live call routing. Toggling it may trigger support notification emails. Not used on DNA tracking numbers.
Deprecated Fields
| Field | Replacement | Notes |
|---|---|---|
| partner_company | company | DNA requests accept either; responses may include both. Prefer company. |
| id | number (DNA) or reference (Call Manager) | Internal IDs still returned but should not be used as lookup keys. |
| call_term_callback | call_term_callbacks (array) | Singular field removed. |
| call2lead_number_selection | phone_number_selection | v1 contacts use old name; v2 contacts use new name. |
| group_name | name | v1 call groups use group_name; v2 uses name. |
TrackingNumberFeatures
An object controlling alert and notification features for a TrackingNumber. All fields are optional — omit any you do not need.
{
"lead_alert_email": ["manager@example.com"],
"lead_alert_sms": ["27821234567"],
"missed_call_alert_email": ["support@example.com"],
"missed_call_alert_sms": [],
"missed_call_response": {
"text": "Sorry we missed your call.",
"enabled": true
},
"meeting_tracker_enabled": false
}
| Field | Type | Description |
|---|---|---|
| lead_alert_email | array of strings | Email addresses to notify when a new lead call is received. |
| lead_alert_sms | array of strings | Phone numbers (E.164, no +) to notify via SMS on new lead calls. |
| missed_call_alert_email | array of strings | Email addresses to notify when a call goes unanswered. |
| missed_call_alert_sms | array of strings | Phone numbers to notify via SMS on missed calls. |
| missed_call_response.text | string | SMS text sent to the caller when their call is missed. |
| missed_call_response.enabled | boolean | Whether to send the missed call SMS response. |
| meeting_tracker_enabled | boolean | Whether meeting tracking is active for this number. |
LeadVehicle
Optional vehicle data sent with DNA (Dynamic Number Allocation) requests. Provides context about the lead's vehicle interest.
{
"received_time": "2026-01-15T09:00:00+02:00",
"id": "lead-id-123",
"sales_executive": {
"id": "exec-1",
"name": "Jane",
"surname": "Smith"
},
"source": {},
"prospect": {},
"vehicle": {},
"trade_in": {}
}
| Field | Type | Description |
|---|---|---|
| received_time | DateTime | When the lead was received. ISO 8601 with timezone offset. |
| id | string | Your system's lead identifier. |
| sales_executive | object | The assigned sales executive. Contains id, name, and surname. |
| source | object | Lead source data (free-form object). |
| prospect | object | Prospect/customer data (free-form object). |
| vehicle | object | Vehicle of interest data (free-form object). |
| trade_in | object | Trade-in vehicle data, if applicable (free-form object). |
StockItem
References a specific stock item (vehicle) with an optional details object.
{
"reference": "stock-uuid",
"details": {
"brand": "Toyota",
"colour": "Silver"
}
}
| Field | Type | Description |
|---|---|---|
| reference | string (UUID) | Unique identifier for the stock item in your inventory system. |
| details | Unstructured | Free-form key-value pairs describing the stock item (see Unstructured below). |
Unstructured
A free-form key-value map where both keys and values are strings. Used in StockItem.details and other extensible fields. There is no fixed schema — include whatever attributes are relevant to your use case.
{
"brand": "Toyota",
"model": "Corolla",
"colour": "Silver",
"year": "2024",
"transmission": "Automatic"
}