List LookupTableRevisionData Jobs

curl --request GET \
  --url https://api.m3ter.com/organizations/{orgId}/lookuptables/{lookupTableId}/revisions/{lookupTableRevisionId}/data/jobs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "version": 123,
      "fileName": "<string>",
      "lookupTableId": "<string>",
      "lookupTableRevisionId": "<string>",
      "destinationLookupTableRevisionId": "<string>",
      "jobDate": "<string>",
      "failureReason": "<string>",
      "downloadUrl": "<string>",
      "downloadUrlExpiry": "<string>"
    }
  ],
  "nextToken": "<string>"
}

List LookupTableRevisionData Jobs

List the Lookup Table Revision Data job Responses for the given Lookup Table Revision.

There are four types of Revision Data jobs:

COPY. Job runs when you use the Copy LookupTableRevisionData endpoint which returns the jobId.
UPLOAD. Job runs when you use the Generate LookupTableRevisionData Upload URL endpoint which returns the jobId.
DOWNLOAD. Job runs when you use the endpoint which returns the jobId.
ARCHIVE. Job runs when you either manually change a DRAFT Revision to PUBLISHED using the Update LookupTableRevision Status endpoint or you publish a DRAFT Revision and the existing PUBLISHED Revision is archived.

NOTE: This endpoint returns the id of each Data job. You then use:

The Get LookupTableRevisionData Job Response endpoint to retrieve a specific Data job Response.
The Delete LookupTableRevisionData Job Response to delete a specific Data job Response.

GET

organizations

{orgId}

lookuptables

{lookupTableId}

revisions

{lookupTableRevisionId}

data

jobs

List LookupTableRevisionData Jobs

curl --request GET \
  --url https://api.m3ter.com/organizations/{orgId}/lookuptables/{lookupTableId}/revisions/{lookupTableRevisionId}/data/jobs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "version": 123,
      "fileName": "<string>",
      "lookupTableId": "<string>",
      "lookupTableRevisionId": "<string>",
      "destinationLookupTableRevisionId": "<string>",
      "jobDate": "<string>",
      "failureReason": "<string>",
      "downloadUrl": "<string>",
      "downloadUrlExpiry": "<string>"
    }
  ],
  "nextToken": "<string>"
}

Authorizations

Authorization

string

header

required

m3ter supports machine to machine authentication using the clientCredentials OAuth2 flow.

The authorizationCode flow controls access for human users via the m3ter Console application.

Path Parameters

orgId

string

required

UUID of the Organization. The Organization represents your company as a direct customer of the m3ter service.

lookupTableId

string

required

UUID of the Lookup Table.

lookupTableRevisionId

string

required

UUID of the Lookup Table Revision.

Query Parameters

pageSize

integer<int32>

The number of Lookup Table Revision Data Job Responses to retrieve per page.

Required range: 1 <= x <= 100

nextToken

string

The nextToken for multi page retrievals

Response

Returns a List of LookupTableRevisionDataJob Responses

data

object[]

Show child attributes

nextToken

string

Delete LookupTableRevisionData Job Response

Get LookupTableRevisionData entry

⌘I