# Retrieve an upload

## Returns

Returns a resource object of type [upload](https://www.datocms.com/docs/content-management-api/resources/upload.md)

## Examples

###### Example Basic example

Code

```javascript
import { buildClient } from "@datocms/cma-client-node";

async function run() {
  const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });

  const uploadId = "q0VNpiNQSkG6z0lif_O1zg";

  const upload = await client.uploads.find(uploadId);

  // Check the 'Returned output' tab for the result ☝️
  console.log(upload);
}

run();
```

Returned output

```javascript
{
  id: "q0VNpiNQSkG6z0lif_O1zg",
  size: 444,
  width: 30,
  height: 30,
  path: "/45/1496845848-digital-cats.jpg",
  basename: "digital-cats",
  filename: "digital-cats.jpg",
  url: "https://www.datocms-assets.com/45/1496845848-digital-cats.jpg",
  format: "jpg",
  author: "Mark Smith",
  copyright: "2020 DatoCMS",
  notes: "Nyan the cat",
  md5: "873c296d0f2b7ee569f2d7ddaebc0d33",
  duration: 62,
  frame_rate: 30,
  blurhash: "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
  thumbhash: "UhqCDQIkrHOfVG8wBa2v39z7CXeqZWFLdg==",
  mux_playback_id: "a1B2c3D4e5F6g7H8i9",
  mux_mp4_highest_res: "high",
  default_field_metadata: {
    alt: { en: "this is the default alternate text" },
    title: { en: "this is the default title" },
    custom_data: { en: { foo: "bar" } },
    focal_point: { x: 0.5, y: 0.5 },
    poster_time: 12.5,
  },
  is_image: true,
  created_at: "2020-04-21T07:57:11.124Z",
  updated_at: "2020-04-21T07:57:11.124Z",
  mime_type: "image/jpeg",
  tags: ["cats"],
  smart_tags: ["robot-cats"],
  exif_info: {
    iso: 10000,
    model: "ILCE-7",
    flash_mode: 16,
    focal_length: 35,
    exposure_time: 0.0166667,
  },
  colors: [
    { red: 206, green: 203, blue: 167, alpha: 255 },
    { red: 158, green: 163, blue: 93, alpha: 255 },
  ],
  meta: {
    antivirus: {
      status: "clean",
      checked_at: "2020-04-21T07:57:11.124Z",
      threat_name: null,
    },
  },
  creator: { type: "account", id: "312" },
  upload_collection: {
    type: "upload_collection",
    id: "uinr2zfqQLeCo_1O0-ao-Q",
  },
}
```

## Related content in "Content Management API"

- [Content Management API Overview](https://www.datocms.com/docs/content-management-api.md)
- [Using the JavaScript CMA client](https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients.md)
- [API versioning](https://www.datocms.com/docs/content-management-api/api-versioning.md)
- [Authentication](https://www.datocms.com/docs/content-management-api/authentication.md)
- [Environments](https://www.datocms.com/docs/content-management-api/setting-the-environment.md)
- [Error codes & handling failures (CMA)](https://www.datocms.com/docs/content-management-api/errors.md)
- [Pagination](https://www.datocms.com/docs/content-management-api/pagination.md)
- [Asynchronous jobs](https://www.datocms.com/docs/content-management-api/async-jobs.md)
- [CMA Technical Limits & Rate Limits](https://www.datocms.com/docs/content-management-api/technical-limits.md)
- [Record](https://www.datocms.com/docs/content-management-api/resources/item.md)
- [Scheduled publication](https://www.datocms.com/docs/content-management-api/resources/scheduled-publication.md)
- [Scheduled unpublishing](https://www.datocms.com/docs/content-management-api/resources/scheduled-unpublishing.md)
- [Upload](https://www.datocms.com/docs/content-management-api/resources/upload.md)
- [Create a new upload](https://www.datocms.com/docs/content-management-api/resources/upload/create.md)
- [List all uploads](https://www.datocms.com/docs/content-management-api/resources/upload/instances.md)
- [Retrieve an upload](https://www.datocms.com/docs/content-management-api/resources/upload/self.md)
- [Delete an upload](https://www.datocms.com/docs/content-management-api/resources/upload/destroy.md)
- [Update an upload](https://www.datocms.com/docs/content-management-api/resources/upload/update.md)
- [Referenced records](https://www.datocms.com/docs/content-management-api/resources/upload/references.md)
- [Add tags to assets in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_tag.md)
- [Put assets into a collection in bulk](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_set_upload_collection.md)
- [Destroy uploads](https://www.datocms.com/docs/content-management-api/resources/upload/bulk_destroy.md)
- [Site](https://www.datocms.com/docs/content-management-api/resources/site.md)
- [Model/Block model](https://www.datocms.com/docs/content-management-api/resources/item-type.md)
- [Field](https://www.datocms.com/docs/content-management-api/resources/field.md)
- [Fieldset](https://www.datocms.com/docs/content-management-api/resources/fieldset.md)
- [Record version](https://www.datocms.com/docs/content-management-api/resources/item-version.md)
- [Upload permission](https://www.datocms.com/docs/content-management-api/resources/upload-request.md)
- [Upload track](https://www.datocms.com/docs/content-management-api/resources/upload-track.md)
- [Manual tags](https://www.datocms.com/docs/content-management-api/resources/upload-tag.md)
- [Smart tags](https://www.datocms.com/docs/content-management-api/resources/upload-smart-tag.md)
- [Upload Collection](https://www.datocms.com/docs/content-management-api/resources/upload-collection.md)
- [Search Index](https://www.datocms.com/docs/content-management-api/resources/search-index.md)
- [Search result](https://www.datocms.com/docs/content-management-api/resources/search-result.md)
- [Search indexing activity](https://www.datocms.com/docs/content-management-api/resources/search-index-event.md)
- [Environment](https://www.datocms.com/docs/content-management-api/resources/environment.md)
- [Maintenance mode](https://www.datocms.com/docs/content-management-api/resources/maintenance-mode.md)
- [Menu Item](https://www.datocms.com/docs/content-management-api/resources/menu-item.md)
- [Schema Menu Item](https://www.datocms.com/docs/content-management-api/resources/schema-menu-item.md)
- [Uploads filter](https://www.datocms.com/docs/content-management-api/resources/upload-filter.md)
- [Model filter](https://www.datocms.com/docs/content-management-api/resources/item-type-filter.md)
- [Plugin](https://www.datocms.com/docs/content-management-api/resources/plugin.md)
- [Workflow](https://www.datocms.com/docs/content-management-api/resources/workflow.md)
- [Asynchronous job](https://www.datocms.com/docs/content-management-api/resources/job.md)
- [Job result](https://www.datocms.com/docs/content-management-api/resources/job-result.md)
- [Account](https://www.datocms.com/docs/content-management-api/resources/account.md)
- [Organization](https://www.datocms.com/docs/content-management-api/resources/organization.md)
- [Invitation](https://www.datocms.com/docs/content-management-api/resources/site-invitation.md)
- [Collaborator](https://www.datocms.com/docs/content-management-api/resources/user.md)
- [Role](https://www.datocms.com/docs/content-management-api/resources/role.md)
- [API token](https://www.datocms.com/docs/content-management-api/resources/access-token.md)
- [Webhook](https://www.datocms.com/docs/content-management-api/resources/webhook.md)
- [Webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call.md)
- [Build trigger](https://www.datocms.com/docs/content-management-api/resources/build-trigger.md)
- [Deploy activity](https://www.datocms.com/docs/content-management-api/resources/build-event.md)
- [Subscription limit](https://www.datocms.com/docs/content-management-api/resources/subscription-limit.md)
- [Subscription feature](https://www.datocms.com/docs/content-management-api/resources/subscription-feature.md)
- [SSO Settings](https://www.datocms.com/docs/content-management-api/resources/sso-settings.md)
- [SSO User](https://www.datocms.com/docs/content-management-api/resources/sso-user.md)
- [SSO Group](https://www.datocms.com/docs/content-management-api/resources/sso-group.md)
- [White-label settings](https://www.datocms.com/docs/content-management-api/resources/white-label-settings.md)
- [Audit log event](https://www.datocms.com/docs/content-management-api/resources/audit-log-event.md)