Skip to main content

Catalog lookups

Resolve valid image types and resolutions from the Gateway before you build a create payload.

Goal​

Call the catalog lookup endpoints so your tasking request references IDs that exist and are active for your organization, not guessed values.

Why call lookups first​

Create accepts a CartItemBaseModel whose cartItemDataList entries carry string dataKey / dataValue pairs (for example POI, ImageTypeID, ImageResolutionID, FirstImageDate, SecondImageDate, ImageProviderID, CloudCover). Those IDs must align with:

  • Results from GetImageTypesList and GetImageResolutions
  • Your account’s EarthLife services configuration (serviceID and allowed dataKey values)

Using stale or invented IDs commonly yields IsSuccess: false or rejected inputs even when authentication succeeds.

Endpoints​

MethodPathReturns
GET/order/Lookup/GetImageTypesListArray of image type models
GET/order/Lookup/GetImageResolutionsArray of resolution models

Both require Authorization: Bearer {access_token} on the Gateway base URL.

List image types​

curl -X GET "https://earthlife.sarsatx.com/gateway/order/Lookup/GetImageTypesList" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Accept: application/json"

Success:

[
  {
    "imageTypeID": 2,
    "nameAr": "خلال النهار",
    "nameEn": "Daytime",
    "previewImage": "",
    "isActive": true,
    "isOpenData": true,
    "isCommercial": true
  },
  {
    "imageTypeID": 3,
    "nameAr": "SAR",
    "nameEn": "SAR",
    "previewImage": "",
    "isActive": true,
    "isOpenData": true,
    "isCommercial": true
  }
]

Prefer active entries that match your product needs (optical options such as Multispectral/Daytime, SAR, Stereo, and others returned by the API). Pass the chosen imageTypeID as a dataValue string in cartItemDataList (example: "2").

List image resolutions​

curl -X GET "https://earthlife.sarsatx.com/gateway/order/Lookup/GetImageResolutions" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Accept: application/json"

Success:

[
  {
    "imageResolutionID": 1,
    "nameEn": "High",
    "minimumValueInCM": 30,
    "maximumValueInCM": 50,
    "isActive": true
  }
]

Always pick a resolution before create and send it with the image type.

Important: Use only an imageResolutionID where "isActive": true. Skip any resolution with "isActive": false.

Failure case​

curl -X GET "https://earthlife.sarsatx.com/gateway/order/Lookup/GetImageTypesList" \
  -H "Accept: application/json"

Without a valid Bearer token the Gateway responds with 401 Unauthorized. Refresh the token and retry.

Service configuration vs public lookups​

Lookups expose shared catalog dimensions (type and resolution). They do not replace your service catalog: each dataKey comes from EarthLife services configuration. For tasking, use "serviceID": 3 (the Tasking service), and take ImageTypeID / ImageResolutionID from the active catalog lookup results.

Next steps​