GenAerial LogoGenAerial
GET/api/external/v1/image-generation

List Generated Images

Retrieves the authenticated user's generated images with temporary S3 URLs. URLs are valid for 2 hours after retrieval.

Request URL

plaintext
https://api.genaerial.com/api/external/v1/image-generation

Query Parameters

ParameterTypeDescription
page(optional)integer

Zero-indexed page number for pagination.

Default: 0

size(optional)integer

Number of results per page (minimum: 1).

Default: 20

sort(optional)array

Sort criteria in the format "property,(asc|desc)". Example: "createdAt,desc"

Responses

200OKapplication/json

Paginated collection of generated images.

json
{
  "content": [
    {
      "id": "img_abc123",
      "url": "https://s3.amazonaws.com/...",
      "coordinates": {
        "latitude": 40.6892,
        "longitude": -74.0445
      },
      "resolution": "FHD",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "totalElements": 42,
  "totalPages": 3,
  "page": 0,
  "size": 20
}
401Unauthorized

Invalid or missing API key.

Code Examples

bash
curl -X GET "https://api.genaerial.com/api/external/v1/image-generation?page=0&size=20" \
  -H "x-api-key: YOUR_API_KEY"