---
title: "Get metadata for a single event"
method: GET
path: "/v3/events/{id}"
tags: ["Events"]
---

# Get metadata for a single event

`GET /v3/events/{id}`

This endpoint returns the detailed event metadata for a specified event. Getty Images news, sports and entertainment 
photographers and videographers cover editorially relevant events occurring around the world.  
All images or video clips produced in association with an event, are assigned the same EventID. 
EventIDs are part of the meta-data returned in SearchForImages Results. Only content produced under a Getty Images 
brand name (Getty Images News, Getty Images Sports, Getty Images Entertainment, Film Magic, Wire Image) will be 
consistently assigned an EventID. The Event framework may also be used to group similar content, such as 
"Hats from the Royal Wedding" or "Odd-ballOffbeat images of the week". 

You'll need an API key and access token to use this resource.

## Path parameters

- `id` integer, required

## Query parameters

- `fields` GettyImagesServicesConnectPublicControllersEventsSingleEventDetailFieldValues[]

## Headers

- `Accept-Language` string — Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).

## Response `200`

OK

- GettyImagesServicesConnectPublicModelsEventsEvent
  - `child_event_count` integer, nullable
  - `child_events` GettyImagesServicesConnectPublicModelsEventsChildEvent[], nullable
    - `editorial_segments` string[], nullable
    - `hero_image` GettyImagesServicesConnectPublicModelsHeroImage
      - `id` string, nullable
      - `display_sizes` GettyImagesServicesConnectPublicModelsHeroImageDisplaySize[], nullable
        - `name` string, nullable
        - `is_watermarked` boolean
        - `uri` string, nullable
    - `id` integer
    - `image_count` integer, nullable
    - `keywords` GettyImagesServicesConnectPublicModelsEventsEventKeyword[], nullable
      - `keyword_id` string, nullable
      - `text` string, nullable
      - `type` string, nullable
      - `relevance` integer, nullable
    - `location` GettyImagesServicesConnectPublicModelsLocationEvent
      - `city` string, nullable
      - `country` string, nullable
      - `state_province` string, nullable
      - `venue` string, nullable
    - `name` string, nullable
    - `start_date` string, date-time, nullable
    - `type` string, nullable
  - `editorial_segments` string[], nullable
  - `hero_image` GettyImagesServicesConnectPublicModelsHeroImage
    - `id` string, nullable
    - `display_sizes` GettyImagesServicesConnectPublicModelsHeroImageDisplaySize[], nullable
      - `name` string, nullable
      - `is_watermarked` boolean
      - `uri` string, nullable
  - `id` integer
  - `image_count` integer, nullable
  - `keywords` GettyImagesServicesConnectPublicModelsEventsEventKeyword[], nullable
    - `keyword_id` string, nullable
    - `text` string, nullable
    - `type` string, nullable
    - `relevance` integer, nullable
  - `location` GettyImagesServicesConnectPublicModelsLocationEvent
    - `city` string, nullable
    - `country` string, nullable
    - `state_province` string, nullable
    - `venue` string, nullable
  - `name` string, nullable
  - `start_date` string, date-time, nullable
  - `type` string, nullable

## Other responses

- `400` — InvalidRequestParameters
- `401` — Unauthorized
- `404` — EventNotFound

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/29f239eeae86/schema)