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"

}