Reference Shared Fields

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.

Company object
{"name": "Cape Town Dealer", "reference": "dealer-cape-town-001"}
FieldTypeDescription
namestringThe company's display name as registered in Logimeter.
referencestringThe 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.

Contact object
{"name": "Jane Smith", "reference": "agent-jane-001"}
FieldTypeDescription
namestringThe contact's full name.
referencestringA 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.

TypeFormatExampleNotes
South African mobile27 + 9 digits27821234567Leading 0 replaced by country code 27.
South African landline27 + 9 digits27114567890E.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).

DateTime example
"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.

ExampleMeaning
08:30:008:30 AM
17:00:005:00 PM
00:00:00Midnight

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

FieldReplacementNotes
partner_companycompanyDNA requests accept either; responses may include both. Prefer company.
idnumber (DNA) or reference (Call Manager)Internal IDs still returned but should not be used as lookup keys.
call_term_callbackcall_term_callbacks (array)Singular field removed.
call2lead_number_selectionphone_number_selectionv1 contacts use old name; v2 contacts use new name.
group_namenamev1 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.

TrackingNumberFeatures object
{
  "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
}
FieldTypeDescription
lead_alert_emailarray of stringsEmail addresses to notify when a new lead call is received.
lead_alert_smsarray of stringsPhone numbers (E.164, no +) to notify via SMS on new lead calls.
missed_call_alert_emailarray of stringsEmail addresses to notify when a call goes unanswered.
missed_call_alert_smsarray of stringsPhone numbers to notify via SMS on missed calls.
missed_call_response.textstringSMS text sent to the caller when their call is missed.
missed_call_response.enabledbooleanWhether to send the missed call SMS response.
meeting_tracker_enabledbooleanWhether 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.

LeadVehicle object
{
  "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": {}
}
FieldTypeDescription
received_timeDateTimeWhen the lead was received. ISO 8601 with timezone offset.
idstringYour system's lead identifier.
sales_executiveobjectThe assigned sales executive. Contains id, name, and surname.
sourceobjectLead source data (free-form object).
prospectobjectProspect/customer data (free-form object).
vehicleobjectVehicle of interest data (free-form object).
trade_inobjectTrade-in vehicle data, if applicable (free-form object).

StockItem

References a specific stock item (vehicle) with an optional details object.

StockItem object
{
  "reference": "stock-uuid",
  "details": {
    "brand": "Toyota",
    "colour": "Silver"
  }
}
FieldTypeDescription
referencestring (UUID)Unique identifier for the stock item in your inventory system.
detailsUnstructuredFree-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.

Unstructured example
{
  "brand": "Toyota",
  "model": "Corolla",
  "colour": "Silver",
  "year": "2024",
  "transmission": "Automatic"
}