Get the event trace history of the event.

GET

/v:version/events/:resourceId/event_trace

GET

/v:version/events/:resourceId/event_trace

1 curl https://test.api.solvimon.com/v1/events//event_trace \
2      -H "X-API-KEY: <apiKey>" \
3      -H "Content-Type: application/json"

1 {
2   "meter_data_id": "md_1234567890abcdef",
3   "customer_id": "cust_9876543210fedcba",
4   "ingest_time": "2024-06-15T09:31:00Z",
5   "received_time": "2024-06-15T09:30:30Z",
6   "processed_time": "2024-06-15T09:31:15Z",
7   "links": [],
8   "object_type": "meter_data_event_trace",
9   "id": "evt_9f8b7c6d5e4a3b2c1d0e",
10   "meter_data": {
11     "object_type": "meter_data",
12     "id": "md_1234567890abcdef",
13     "reference": "MD-20240615-001",
14     "type": "INGEST",
15     "customer_id": "cust_9876543210fedcba",
16     "customer_reference": "CUST-2024-06",
17     "customer": {
18       "reference": "CUST-2024-06",
19       "type": "ORGANIZATION",
20       "email": "contact@acmecorp.com",
21       "roles": [
22         "DEFAULT"
23       ],
24       "object_type": "customer",
25       "id": "cust_9876543210fedcba",
26       "created_at": "2024-06-01T08:00:00Z",
27       "parent_customer_id": "cust_parent_001",
28       "parent_customer_ids": [
29         "cust_parent_001"
30       ],
31       "status": "ACTIVE",
32       "timezone": "America/New_York",
33       "notification_preferences": [
34         {
35           "type": "INVOICE",
36           "channels": [
37             {
38               "type": "EMAIL",
39               "enabled": true
40             }
41           ]
42         }
43       ],
44       "locale": "en-US",
45       "individual": {
46         "name": {
47           "first_name": "John",
48           "last_name": "Doe",
49           "infix": ""
50         },
51         "residential_address": {
52           "line1": "123 Elm Street",
53           "line2": "Suite 400",
54           "city": "Springfield",
55           "postal_code": "62704",
56           "state": "IL",
57           "country": "US"
58         }
59       },
60       "organization": {
61         "legal_name": "Acme Corporation",
62         "tax_id": "12-3456789",
63         "tax_ids": [
64           {
65             "id": "12-3456789",
66             "type": "EIN"
67           }
68         ],
69         "registration_number": "REG-2024-ACME",
70         "tax_exempt": false,
71         "tax_exempt_note": "",
72         "registered_address": {
73           "line1": "123 Elm Street",
74           "line2": "Suite 400",
75           "city": "Springfield",
76           "postal_code": "62704",
77           "state": "IL",
78           "country": "US"
79         }
80       },
81       "custom_fields": [
82         {
83           "id": "cf_001",
84           "reference": "preferred_contact",
85           "value": "email",
86           "values": [
87             "email"
88           ],
89           "integration_details": {
90             "payment_gateway_variant": "STRIPE",
91             "id": "int_001",
92             "reference": "stripe_integration",
93             "adyen": {
94               "recurring_detail_reference": ""
95             },
96             "stripe": {
97               "payment_method_id": "pm_1GqIC8Lz0qyl6XeW3xYz"
98             }
99           }
100         }
101       ],
102       "processing_only": false,
103       "pricing_plan_subscription_selector": {
104         "data": [
105           {
106             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
107             "value": "US"
108           }
109         ],
110         "rules": [
111           {
112             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
113             "type": "EQUALS"
114           }
115         ],
116         "filters": [
117           {
118             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
119             "type": "EQUALS",
120             "value": "US"
121           }
122         ],
123         "fallback": "LATEST"
124       },
125       "linked_integrations": [
126         {
127           "id": "int_001",
128           "link_details": [
129             {
130               "url": "https://dashboard.stripe.com/customers/cust_9876543210fedcba",
131               "custom_field_name": "stripe_customer_link"
132             }
133           ]
134         }
135       ]
136     },
137     "meter_id": "meter_001",
138     "meter_reference": "MTR-20240615-001",
139     "pricing_plan_subscription_id": "pps_20240615_001",
140     "pricing_plan_subscription_reference": "PPS-2024-06-001",
141     "pricing_plan_subscription_selector": {
142       "data": [
143         {
144           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
145           "value": "US"
146         }
147       ],
148       "rules": [
149         {
150           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
151           "type": "EQUALS"
152         }
153       ],
154       "filters": [
155         {
156           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
157           "type": "EQUALS",
158           "value": "US"
159         }
160       ],
161       "fallback": "LATEST"
162     },
163     "timestamp": "2024-06-15T09:30:00Z",
164     "created_at": "2024-06-15T09:31:00Z",
165     "meter_properties": [
166       {
167         "id": "mp_001",
168         "reference": "location",
169         "value": "warehouse-5"
170       }
171     ],
172     "meter_values": [
173       {
174         "id": "mv_001",
175         "reference": "energy_consumed",
176         "number": "1500",
177         "amount": {
178           "quantity": "375.00",
179           "currency": "USD"
180         },
181         "count": "1"
182       }
183     ],
184     "cost_prediction": {
185       "response": "OK",
186       "details": [
187         {
188           "customer_id": "cust_9876543210fedcba",
189           "periods": [
190             {
191               "period_order": 1,
192               "start_at": "2024-06-01T00:00:00Z",
193               "end_at": "2024-06-30T23:59:59Z",
194               "tax_categories": [
195                 {
196                   "category": "STANDARD",
197                   "percentage": "7.14",
198                   "name": "Sales Tax",
199                   "base_amount": {
200                     "quantity": "350.00",
201                     "currency": "USD"
202                   },
203                   "tax_amount": {
204                     "quantity": "25.00",
205                     "currency": "USD"
206                   },
207                   "total_amount": {
208                     "quantity": "375.00",
209                     "currency": "USD"
210                   },
211                   "local_amounts": {
212                     "display": true,
213                     "base_amount": {
214                       "quantity": "350.00",
215                       "currency": "USD"
216                     },
217                     "tax_amount": {
218                       "quantity": "25.00",
219                       "currency": "USD"
220                     },
221                     "total_amount": {
222                       "quantity": "375.00",
223                       "currency": "USD"
224                     },
225                     "used_exchange_rate": {
226                       "currency": "USD",
227                       "base_currency": "USD",
228                       "rate_timestamp": "2024-06-15T00:00:00Z",
229                       "rate": "1.0",
230                       "source": "Internal"
231                     }
232                   },
233                   "notes": [
234                     "Applicable state sales tax"
235                   ],
236                   "rates": [
237                     {
238                       "name": "State Sales Tax",
239                       "percentage": "7.14",
240                       "tax_amount": {
241                         "quantity": "25.00",
242                         "currency": "USD"
243                       }
244                     }
245                   ]
246                 }
247               ],
248               "amount_excluding_tax": {
249                 "quantity": "350.00",
250                 "currency": "USD"
251               },
252               "amount_including_tax": {
253                 "quantity": "375.00",
254                 "currency": "USD"
255               },
256               "billing_period": {
257                 "type": "DAY",
258                 "value": 1
259               },
260               "groups": []
261             }
262           ],
263           "amount_excluding_tax": {
264             "quantity": "350.00",
265             "currency": "USD"
266           },
267           "amount_including_tax": {
268             "quantity": "375.00",
269             "currency": "USD"
270           },
271           "tax_summary": {
272             "country_code": "US",
273             "base_amount": {
274               "quantity": "350.00",
275               "currency": "USD"
276             },
277             "tax_amount": {
278               "quantity": "25.00",
279               "currency": "USD"
280             },
281             "total_amount": {
282               "quantity": "375.00",
283               "currency": "USD"
284             },
285             "local_amounts": {
286               "display": true,
287               "base_amount": {
288                 "quantity": "350.00",
289                 "currency": "USD"
290               },
291               "tax_amount": {
292                 "quantity": "25.00",
293                 "currency": "USD"
294               },
295               "total_amount": {
296                 "quantity": "375.00",
297                 "currency": "USD"
298               },
299               "used_exchange_rate": {
300                 "currency": "USD",
301                 "base_currency": "USD",
302                 "rate_timestamp": "2024-06-15T00:00:00Z",
303                 "rate": "1.0",
304                 "source": "Internal"
305               }
306             },
307             "notes": [
308               "Standard sales tax applied"
309             ]
310           }
311         }
312       ],
313       "used_change_rates": [
314         {
315           "currency": "USD",
316           "base_currency": "USD",
317           "rate_timestamp": "2024-06-15T00:00:00Z",
318           "rate": "1.0",
319           "source": "Internal"
320         }
321       ]
322     },
323     "processed_details": {
324       "type": "DEFAULT",
325       "duplicate": {
326         "of_meter_data_id": ""
327       },
328       "not_matched": {
329         "variant": ""
330       },
331       "duplicate_of_meter_data_id": ""
332     },
333     "deleted": false
334   },
335   "customer": {
336     "reference": "CUST-2024-06",
337     "type": "ORGANIZATION",
338     "email": "contact@acmecorp.com",
339     "roles": [
340       "DEFAULT"
341     ],
342     "object_type": "customer",
343     "id": "cust_9876543210fedcba",
344     "created_at": "2024-06-01T08:00:00Z",
345     "parent_customer_id": "cust_parent_001",
346     "parent_customer_ids": [
347       "cust_parent_001"
348     ],
349     "status": "ACTIVE",
350     "timezone": "America/New_York",
351     "notification_preferences": [
352       {
353         "type": "INVOICE",
354         "channels": [
355           {
356             "type": "EMAIL",
357             "enabled": true
358           }
359         ]
360       }
361     ],
362     "locale": "en-US",
363     "individual": {
364       "name": {
365         "first_name": "John",
366         "last_name": "Doe",
367         "infix": ""
368       },
369       "residential_address": {
370         "line1": "123 Elm Street",
371         "line2": "Suite 400",
372         "city": "Springfield",
373         "postal_code": "62704",
374         "state": "IL",
375         "country": "US"
376       }
377     },
378     "organization": {
379       "legal_name": "Acme Corporation",
380       "tax_id": "12-3456789",
381       "tax_ids": [
382         {
383           "id": "12-3456789",
384           "type": "EIN"
385         }
386       ],
387       "registration_number": "REG-2024-ACME",
388       "tax_exempt": false,
389       "tax_exempt_note": "",
390       "registered_address": {
391         "line1": "123 Elm Street",
392         "line2": "Suite 400",
393         "city": "Springfield",
394         "postal_code": "62704",
395         "state": "IL",
396         "country": "US"
397       }
398     },
399     "custom_fields": [
400       {
401         "id": "cf_001",
402         "reference": "preferred_contact",
403         "value": "email",
404         "values": [
405           "email"
406         ],
407         "integration_details": {
408           "payment_gateway_variant": "STRIPE",
409           "id": "int_001",
410           "reference": "stripe_integration",
411           "adyen": {
412             "recurring_detail_reference": ""
413           },
414           "stripe": {
415             "payment_method_id": "pm_1GqIC8Lz0qyl6XeW3xYz"
416           }
417         }
418       }
419     ],
420     "processing_only": false,
421     "pricing_plan_subscription_selector": {
422       "data": [
423         {
424           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
425           "value": "US"
426         }
427       ],
428       "rules": [
429         {
430           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
431           "type": "EQUALS"
432         }
433       ],
434       "filters": [
435         {
436           "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
437           "type": "EQUALS",
438           "value": "US"
439         }
440       ],
441       "fallback": "LATEST"
442     },
443     "linked_integrations": [
444       {
445         "id": "int_001",
446         "link_details": [
447           {
448             "url": "https://dashboard.stripe.com/customers/cust_9876543210fedcba",
449             "custom_field_name": "stripe_customer_link"
450           }
451         ]
452       }
453     ]
454   }
455 }

Requires the METER_DATA.EVENT_TRACE.VIEW permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdstringRequiredDefaults to

The ID of the resource to be requested.

Headers

x-platform-idstringOptional

Platform ID.

Query parameters

expand[]list of stringsOptional

The id fields of the resources that are going to be expanded.

cost_predictionbooleanOptional

The option to return cost prediction.

Response

meter_data_idstring

customer_idstring

ingest_timestring

received_timestring

processed_timestring

linkslist of objects

object_typestring or nullRead-only

idstring or nullRead-only

meter_dataobject or null

customerobject or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error