Image Metadata

List image metadata

Imago API

Version: 1.4.2

Searches for metadata of images matching a search criteria.

Servers
https://imago.api.seequent.com/integrate/2

Parameters

Restrict searching to this workspace.

Restrict searching to this workspace. ID must be an exact match.

Restrict searching to this dataset.

Restrict searching to this dataset. ID must be an exact match.

Restrict searching to this collection.

Restrict searching to this collection. ID must be an exact match.

Restrict searching to this imagery type

Restrict searching to this imagery type. ID must be an exact match.

Restrict searching to this imagery.

Restrict searching to this imagery. ID must be an exact match.

Restrict searching to this image type

Restrict searching to this image type. ID must be an exact match.

Restrict searching to this image. ID must be an exact match.

Determines how the search pattern matches on the name fields.
Default value: equals
Allowed values: 'equals', 'includes', 'startswith', 'endswith', 'like'

Restrict searching to images that have been updated in the last number of specified days.

Restrict searching to images that have been uploaded in the last number of specified days.

Restrict searching to images updated after the given timestamp. This uses the date-time notation as defined by RFC 3339. For example, 2017-07-21T17:32:28Z. This will override updatedSince if both are provided.

Restrict searching to images uploaded after the given timestamp. This uses the date-time notation as defined by RFC 3339. For example, 2017-07-21T17:32:28Z. This will override uploadedSince if both are provided.

Limit how many images are returned. The default and maximum setting restricts the output to 1000 images.

Return images starting at this offset.

If set to true, only return deleted images. If set to false, only return active images. defaults to false.

Returns

200

Successful response.

List of matching images

Image identifier.

Checksum value for the image.

Image's height in pixels.

Image's width in pixels.

Size of image file.

Image's mime type.

User account that uploaded the image.

Date/time that the image was uploaded.

Timed access to a URL to directly download the image.

Last datetime that the image was updated.

Elevation/Z coordinate of the image.

Latitude/Y coordinate of the image.

Longitude/X coordinate of the image.

End depth of the image.

Start depth of the image.

Workspace identifier that the image belongs to.

Workspace name that the image belongs to.

Dataset identifier that the image belongs to.

Dataset name that the image belongs to.

Collection identifier that the image belongs to.

Collection name that the image belongs to.

Imagery type identifier that the image belongs to.

Imagery type name that the image belongs to.

Imagery identifier that the image belongs to.

Imagery name that the image belongs to.

Image type identifier.

Image type name.

The maximum number of items to return. Optional.

The number of items to skip before starting to collect the result set.

Endpoint

GET

/image-metadata

Request

cURL

​

curl -X GET 'https://imago.api.seequent.com/integrate/2/image-metadata' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Response

{
  "images": [
    {
      "id": "e2f26f0d-51c8-468e-b02f-29b4dc2217a2",
      "workspaceId": "a27b51bf-b918-4fb4-a28f-4f089bf646a8",
      "workspaceName": "Firefly Resource Development",
      "datasetId": "71b93d30-8e5f-4b07-9f08-8e6bf5a72a50",
      "datasetName": "Drilling Chips",
      "collectionId": "054bf4c2-84cc-4d30-b4dc-cc81c77b7f25",
      "collectionName": "RC-01001",
      "imageryTypeId": "6a69bf8e-c03c-4ed2-8a62-d6feac838f12",
      "imageryTypeName": "Chips",
      "imageryId": "b91119e8-cee5-4c11-ad14-fe1dcb0c1c66",
      "imageryName": "Hole 1",
      "imageTypeId": "f16c5dbe-f455-4076-8358-ffda8f538814",
      "imageTypeName": "Wet",
      "updatedAt": "2011-10-05T14:48:00.000Z",
      "uploadedOn": "2022-05-02T06:25:32.085Z",
      "uploadedBy": "ImagoLive",
      "mimeType": "image/png",
      "fileSize": 40192,
      "width": 1024,
      "height": 768,
      "checksum": "x7Rpt+5ET3C3vQataO7tEA==",
      "startDepth": 5,
      "endDepth": 15,
      "url": "https://imago.api.seequent.com/integrate/2/image/b91119e8-cee5-4c11-ad14-fe1dcb0c1c66/?userId=34a3f4ae-d53c-43d4-8545-a552c2a24c54&start=2025-04-23T03:59:36.499Z&expiry=2025-04-23T15:59:36.499Z&sig=4284b5576fffd3ebb94740025415aa2138d514139c5c61c5ef0b7af912da3fb8",
      "x": 10,
      "y": 20,
      "z": 30
    }
  ],
  "meta": {
    "limit": 1000,
    "offset": 0
  }
}