Get meters job status
| Time | Status | User Agent | |
|---|---|---|---|
| Make a request to see history. |
URL Expired
The URL for this request expired after 30 days.
📘
Job & Asset Statuses Skip link to Job & Asset Statuses
For more details on these statuses, see STEP 2 within the Partner-Created Meters guide.
job_id
uuid
required
The job ID returned when running a create meters batch job.
``200 Job details
object
job_id
uuid
required
The id of the create meters job
status
string
enum
required
PROCESSING``FAILED``COMPLETED``COMPLETED_WITH_ERRORS
file_name
string
The original name of the file uploaded to the Job. If the file was uploaded before this field was introduced, this value will be null as the original file name was not available at that time.
assets_count
integer
The number of assets that were created, updated, or failed as a result of the API call.
assets_created_count
integer
The number of assets that were created as a result of the API call.
assets_updated_count
integer
The number of assets that were updated as a result of the API call.
assets_failed_count
integer
The number of assets that failed as a result of the API call.
transmission_regions
array of objects
Defines the transmission region of the meter
CAISO``ERCOT``NYISO``ISONE``PJM``SERC``WECC_SW``WECC_PC
created_at
date-time
required
updated_at
date-time
required
assets
array of objects
Statuses of individual assets in the job queue.
assets
object
This is a temporary entity that is created to give you a way to track the status of the asset creation process.
partner_reference
string
required
length between 3 and 256
^[^\/\\?\]\[{}!#$%^&*()<>|]{3,256}$
The partner-supplied reference ID to help identify the customer or site that a Leap meter correlates to a partner’s internal systems.
status
string
enum
required
PROCESSING``FAILED``DUPLICATE``COMPLETED``MULTIPLE_PARTNER_REFERENCE
status_detail
object
required
Key-value map of fields that had errors, warnings or were modified during upload with additional information about what happened.
status_detail object
created_at
date-time
meter_id
uuid
If a meter got created or updated on Leap's platform successfully (status = COMPLETED), the meter ID will be populated in this field, so you can use it to do API calls in other parts of Leap's system.
Base URL
https://api.staging.leap.energy/v1.1/jobs/meters/{job_id}
xxxxxxxxxx
curl --request GET \
--url https://api.staging.leap.energy/v1.1/jobs/meters/ \
--header 'accept: application/json'
xxxxxxxxxx
{
"assets": [
{
"partner_reference": "test-device-123",
"status": "COMPLETED",
"status_detail": {
"name": "METER_CREATED",
"description": "A new meter was created."
},
"created_at": "2024-03-21T09:43:51.186Z",
"meter_id": "87654321-4321-8888-6666-2c963f66afa3"
}
],
"job_id": "638451c8-4b81-4b91-ab43-c0ba0c5a0336",
"status": "COMPLETED",
"created_at": "2024-03-21T09:43:51.186Z",
"updated_at": "2024-03-21T09:43:51.186Z"
}