---
title: "Get details on a registered file"
method: GET
path: "/v3/ai/file-registrations/{fileRegistrationId}"
tags: ["AiGenerator"]
---

# Get details on a registered file

`GET /v3/ai/file-registrations/{fileRegistrationId}`

## Request

- Base URL: `https://api.gettyimages.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gettyimages.com/v3/ai/file-registrations/{fileRegistrationId}`
- Auth: one of:
  - API key in header `Api-Key`
  - OAuth 2
    - Authorization code: `https://authentication.gettyimages.com/oauth2/auth`
    - Client credentials
    - Password
    - Token URL: `https://authentication.gettyimages.com/oauth2/token`
- TypeScript: <https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/ai/file-registrations/:fileRegistrationId/get.ts> (a function with typed inputs; its response is checked against the schema)

# Get Registered File Details

Gets details for a registered file.  This endpoint is used after a call to `POST beta/ai/file-registrations`, passing the `id` value from the result of that call.

## Path parameters

- `fileRegistrationId` string, required

## Response `200`

Returns the response

- GetFileRegistrationResponse
  - `id` string, nullable
  - `preview_urls` PreviewUrl[], nullable
    - `preview_size` string, nullable
    - `image_url` string, nullable
    - `width` integer
    - `height` integer

## Other responses

- `400`: The request was invalid
- `403`: Not authorized
- `404`: FileRegistrationIdNotFound

## Changes

- **2025-11-20** `81cb0e852242`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/ai/file-registrations/:fileRegistrationId/get.md)

---

[API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [All operations](https://skmtc.dev/gettyimages/apis/getty-images-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gettyimages/apis/getty-images-api/revisions/f20ce986456b?raw)