Getty Images History API
The History API from Getty Images — 2 operation(s) for history.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getty-images-history-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Getty Images History API
version: '3'
description: '
Developer resources for the Getty Images API including SDK, documentation,
release notes, status, notifications and sample code.'
servers:
- url: https://api.gettyimages.com
description: Base URL declared by the provider in apis.yml (roadmap#122).
security:
- Api-Key: []
- OAuth2: []
tags:
- name: History
paths:
/v3/ai/generation-history:
get:
tags:
- History
summary: Retrieve history of AI generations
description: '# AI Generator - Generation History
Get the history of AI generation requests.'
parameters:
- name: date_start
in: query
description: "If included, limits the results to those generation requests made on or after date_start. Both dates and datetimes are supported. \nDates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. \nDatetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ."
style: form
schema:
type: string
format: date-time
- name: date_end
in: query
description: "If included, limits the results to those generation requests made on or before date_end. Both dates and datetimes are supported. \nDates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. \nDatetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ."
style: form
schema:
type: string
format: date-time
- name: media_type
in: query
description: If included, limits the results to those generation requests made for the given media type.
style: form
schema:
$ref: '#/components/schemas/MediaType'
- name: page_size
in: query
description: The page size of results. Default is 30.
style: form
schema:
maximum: 1000
minimum: 1
type: integer
format: int32
- name: page
in: query
description: The page number of results. Default is 1.
style: form
schema:
maximum: 2147483647
minimum: 1
type: integer
format: int32
- name: product_ids
in: query
description: If included, limits the results to only those requests made against the indicated products.
style: form
schema:
type: array
items:
type: integer
format: int32
- name: company_generations
in: query
description: "If `true`, returns the list of previously downloaded images for all users in\n your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for\n more information. Default is `false`."
style: form
schema:
type: boolean
default: false
responses:
'200':
description: Returns the history of AI generations
content:
text/plain:
schema:
$ref: '#/components/schemas/GenerationHistoryResponse'
application/json:
schema:
$ref: '#/components/schemas/GenerationHistoryResponse'
text/json:
schema:
$ref: '#/components/schemas/GenerationHistoryResponse'
'403':
description: Company generations were requested but your account is not configured for access.
/v3/ai/generation-history/{generationRequestId}:
get:
tags:
- History
summary: Retrieve history item for an individual generation request
parameters:
- name: generationRequestId
in: path
description: The ID from a previous request to generate images
required: true
style: simple
schema:
type: string
responses:
'200':
description: Returns the history item for the request
content:
text/plain:
schema:
$ref: '#/components/schemas/GenerationHistoryItemResponse'
application/json:
schema:
$ref: '#/components/schemas/GenerationHistoryItemResponse'
text/json:
schema:
$ref: '#/components/schemas/GenerationHistoryItemResponse'
'403':
description: NotAuthorized
'404':
description: The request ID was not found
components:
schemas:
Mood:
enum:
- black_and_white
- warm
- cool
- natural
- vivid
- dramatic
- bold
type: string
AssetDetail:
type: object
properties:
id:
type:
- string
- 'null'
additionalProperties: false
GenerationType:
enum:
- text_to_image
- variation
- extend
- refine
- background_removal
- influence_color_by_image
- influence_composition_by_image
- object_removal
- influence_outline_by_image
- background_generation
type: string
PreviewUrl:
type: object
properties:
preview_size:
type:
- string
- 'null'
image_url:
type:
- string
- 'null'
width:
type: integer
format: int32
height:
type: integer
format: int32
additionalProperties: false
GenerationHistoryItemResponse:
type: object
properties:
generation_request_id:
type:
- string
- 'null'
description: The identifier for the request
seed:
type:
- integer
- 'null'
description: The seed used for the generation
format: int32
generation_date:
type: string
description: ''
format: date-time
product_revoked_date:
type:
- string
- 'null'
description: If the the product against which the generation was made has been revoked, this is the date of that revocation.
format: date-time
prompt:
type:
- string
- 'null'
description: The prompt that was used for the request
negative_prompt:
type:
- string
- 'null'
description: The negative prompt (if any) that was used for the request
product_id:
type: integer
description: ''
format: int32
notes:
type:
- string
- 'null'
description: ''
project_code:
type:
- string
- 'null'
description: ''
generation_type:
$ref: '#/components/schemas/GenerationType'
generation_options:
$ref: '#/components/schemas/GenerationOptions'
source_generation_request:
$ref: '#/components/schemas/SourceGenerationRequest'
original_asset:
$ref: '#/components/schemas/AssetDetail'
results:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GenerationHistoryResult'
description: ''
user:
$ref: '#/components/schemas/User'
additionalProperties: false
description: Detail on a specific historical generation
SourceGenerationRequest:
type: object
properties:
source_generation_request_id:
type:
- string
- 'null'
source_generation_result_index:
type: integer
format: int32
additionalProperties: false
GenerationHistoryResult:
type: object
properties:
index:
type: integer
description: The index of the result from the original generation
format: int32
is_blocked:
type: boolean
description: If `true` the result was blocked due to AI generation policy
preview_urls:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/PreviewUrl'
description: The preview URLs for the result
additionalProperties: false
description: Individual generated result from a given generation request/response
MediaType:
enum:
- photography
- illustration
type: string
GenerationOptions:
type: object
properties:
media_type:
$ref: '#/components/schemas/MediaType'
aspect_ratio:
type:
- string
- 'null'
mood:
$ref: '#/components/schemas/Mood'
additionalProperties: false
GenerationHistoryResponse:
type: object
properties:
generations:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GenerationHistoryItemResponse'
description: Current page of generations
result_count:
type: integer
description: The total count of results, ignoring paging
format: int32
additionalProperties: false
description: Full generation history response
User:
type: object
properties:
username:
type:
- string
- 'null'
first_name:
type:
- string
- 'null'
middle_name:
type:
- string
- 'null'
last_name:
type:
- string
- 'null'
additionalProperties: false
securitySchemes:
Api-Key:
type: apiKey
name: Api-Key
in: header
OAuth2:
type: oauth2
flows:
password:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
clientCredentials:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
authorizationCode:
authorizationUrl: https://api.gettyimages.com/v4/oauth2/auth
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}