---
title: "Retrieve derivatives"
url: "https://earlyaccess.developers.bynder.com/apis/account-api-1/versions/c8396a1a-c88c-416a-940f-8161e23ef316/paths/api-v4-account-derivatives/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/account-api-1/versions/c8396a1a-c88c-416a-940f-8161e23ef316.md

# Retrieve derivatives

`GET` `/api/v4/account/derivatives`

A derivative is a file that is based on another source, for example, a low-resolution representation of a print-quality photo. During the upload process, Bynder can automatically create pre-defined image derivatives with different dimensions, quality, and format. Bynder can either maintain the original aspect ratio of an image, or crop or pad an image to fit the specified dimensions. We can create smaller versions of your original image asset in both a JPG and PNG file extension. However, the resolution of derivatives can't be larger than the original file.

## Responses

- `200` - Derivatives retrieved successfully

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Account API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/account/derivatives:
    get:
      description: >
        A derivative is a file that is based on another source, for example, a
        low-resolution representation of a print-quality photo. During the
        upload process, Bynder can automatically create pre-defined image
        derivatives with different dimensions, quality, and format. Bynder can
        either maintain the original aspect ratio of an image, or crop or pad an
        image to fit the specified dimensions. We can create smaller versions of
        your original image asset in both a JPG and PNG file extension. However,
        the resolution of derivatives can't be larger than the original file.
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  properties:
                    allowedTypes:
                      example: ""
                      type: string
                    dpi:
                      example: -1
                      type: integer
                    height:
                      example: 500
                      type: integer
                    isCrop:
                      example: true
                      type: boolean
                    isExtent:
                      example: false
                      type: boolean
                    isOnTheFly:
                      example: true
                      type: boolean
                    isPublic:
                      example: true
                      type: boolean
                    prefix:
                      example: 500x500
                      type: string
                    width:
                      example: 500
                      type: integer
                  type: object
                type: array
          description: Derivatives retrieved successfully
      summary: Retrieve derivatives
      tags:
        - Account
security:
  - OAuth2: []
  - permanentToken: []
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```