---
title: "Service: /groups/{group}/images/find [GET] (obsolete)"
source: https://dev.pageseeder.com/reference/version_5/services/find-group-image-GET.html
description: "Find images"
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~782
---

# /groups/\{group\}/images/find \[GET\]

| Property | Value |
| --- | --- |
| Path: | /groups/{group}/images/find |
| Method: | GET |
| Generator: | obsolete |
| Version: |  |
| Since: |  |
| Deprecated: | 5.9400 |
| Obsolete: | 6.0000 |
| Cache control: | max-age=30, must-revalidate |
| API Support: | OBSOLETE |
| Generated: | 2022-07-01 |

## Description

> **Deprecated:** Use [Service: /groups/\{group\}/search \[GET\]](../../../api/services/group-search-GET.md) with `filters=pssubtype:image` instead.

Find images in the current group matching the criteria specified in the request.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| folder | The folder containing the images (includes subfolders) | no | path |  |
| page | The result page for when results span over multiple pages | no | long | `1` |
| pagesize | The number of results per page | no | long | `20` |
| prefix | The prefix the images must start with | no  | string |  |

## Permission

This service is restricted to guest and higher.

## Response

The XML format is based on search query and results:

```xml

<graphics-search>
  <search-results index="[Index ID]">
    <query lucene="[lucene query]">
      <!-- Format of graphics query may change without notice -->
      <graphic-query empty="false"
                     query="psmediatype:image/jpeg
                            psmediatype:image/gif
                            psmediatype:image/png
                            psmediatype:image/bmp">
        <image-formats>
          <format name="JPEG" mediatype="image/jpeg"/>
          <format name="GIF" mediatype="image/gif"/>
          <format name="PNG" mediatype="image/png"/>
          <format name="BMP" mediatype="image/bmp"/>
        </image-formats>
        <sort by="relevance"/>
      </graphic-query>
    </query>
    <metadata>
      <hits>
        <per-page>20</per-page>
        <total>1</total>
      </hits>
      <page>
        <first-hit>1</first-hit>
        <last-hit>1</last-hit>
        <current>1</current>
        <last>1</last>
      </page>
    </metadata>
    <documents>
      <document>
        <score>[score between 0 and 1]</score>
        <field name="psid">[URI ID]</field>
        <field name="pstitle">[URI Title]</field>
        <field name="pstype">document</field>
        <field name="psmediatype">[media type (starts with 'image/')]
        </field>
        <field name="psmodifieddate" datetime="[datetime]">[datetime]
        </field>
        <field name="psfilename">[URI File name]</field>
        <field name="psurifolder">[URI Folder]</field>
        <field name="psfolder">[URI Folder]</field>
        <field name="pssize">[File size in bytes]</field>
        <field name="psdocid">[Doc ID]</field>
        <!-- The image dimension may not always be available -->
        <field name="pswidth">[Image width in pixels]</field>
        <field name="psheight">[Image height in pixels]</field>
      </document>
      ...
    </documents>
  </search-results>
</graphics-search>
```

## Error Handling

No specific errors expected for this service.