# Get image

`GET /images/{publicID}`

API version: `v2026.10.00`. Send `X-Moov-Version: v2026.10.00` to get the behavior described here.

> AI agents: search and read all Moov docs with the docs MCP server at https://docs.moov.io/mcp (no API key). Setup: https://docs.moov.io/guides/developer-tools/mcp-ai/docs-mcp/index.md

Get an image by its public ID.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `if-none-match` | header | string |  |  |
| `publicID` | path | string | Yes | A unique identifier for an image, used in public image links. |
| `size` | query | string |  | Optional parameter to request a resized version of the image (WxH). If either dimension is 0, the image will be scaled proportionally based on the non-zero dimension. Dimensions are capped at 2048 pixels. A default size of 400x400 will be used if this parameter is omitted. |

## Response 200

Response body for returning the raw image bytes.

Type: `string (binary)`

## Errors

| Status | Meaning |
| --- | --- |
| 304 | The resource has not changed; client may use its cached representation. |
| 404 | The requested resource was not found. |
| 429 | Request was refused due to rate limiting. |
| 500 | The request failed due to an unexpected error. |
| 502 | The request failed because a downstream service returned an invalid response. |
| 503 | The request failed because a downstream service is unavailable. |
| 504 | The request failed because a downstream service failed to respond. |

## Examples

### cURL

```bash
curl -X GET "https://api.moov.io/images/{publicID}"
```

### Typescript (SDK)

```typescript
import { Moov } from "@moovio/sdk";

const moov = new Moov();

async function run() {
  const result = await moov.images.getPublic({
    publicID: "<id>",
  });

  console.log(result);
}

run();
```

Full reference with SDK examples in every language: https://docs.moov.io/api/v2026.10.00/tools/images/get-image/