> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

The Contentful Images API allows the retrieval and manipulation of image files referenced from [assets](/references/content-delivery-api/overview).

The JSON representation of an asset in Contentful looks like this:

```json
"fields": {
    "title": "Playsam Streamliner",
    "file": {
      "fileName": "quwowooybuqbl6ntboz3.jpg",
      "contentType": "image/jpg",
      "details": {
        "image": {
          "width": 600,
          "height": 446
        },
        "size": 27187
      },
      "url": "//images.ctfassets.net/yadj1kx9rmg0/wtrHxeu3zEoEce2MokCSi/cf6f68efdcf625fdc060607df0f3baef/quwowooybuqbl6ntboz3.jpg"
    }
  }
```

This reference covers the parameters you can append to the URL specified in the `file.url` field to manipulate and convert images.

To upload images to Contentful, refer [here](/references/content-management-api/overview).

**Note:** As per the [Technical Limits](https://www.contentful.com/developers/docs/technical-limits/) specifications, size of an image uploaded must not exceed 100MB. Images exceeding the size limit are treated as [assets](/references/content-delivery-api/overview) and the transformation features offered by the API are not applicable.

> **Info**
>
> **Note:** For EU data residency customers, the Base URL is *[https://images.eu.ctfassets.net](https://images.eu.ctfassets.net)*.

## Basic API information

API Base URL `https://images.ctfassets.net`
*This is a read-only API*