Accessing User Images

Learn how to retrieve your generated images through the API.

Endpoint

GET https://dreamshot.io/api/v1/images

Authentication

Include your API token in the request header:

Authorization: Bearer YOUR_API_TOKEN

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
limit	integer	10	Results per page (10-100)

Response Format

{
  "images": [
    {
      "id": 3980,
      "url": "https://dreamshot.io/images/30bf107a-7b84-4f03-a0f0-fa612be0e243.png",
      "created_at": 1732140731,
      "favorited": false
    },
    {
      "id": 3979,
      "url": "https://dreamshot.io/images/64833aa9-e251-4fbd-8643-9e3c2e2aff32.png",
      "created_at": 1732140709,
      "favorited": false
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "pages": 68,
    "count": 5,
    "limit": 5
  }
}

Example Request

curl -X GET "https://dreamshot.io/api/v1/images?page=1&limit=10"
-H "Authorization: Bearer YOUR_API_TOKEN"