---
title: "Get metadata for multiple events"
method: GET
path: "/v3/events"
tags: ["Events"]
---

# Get metadata for multiple events

`GET /v3/events`

This endpoint returns the detailed event metadata for all specified events. 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.

## Query parameters

- `ids` integer[]
- `fields` GettyImagesServicesConnectPublicControllersEventsEventDetailFieldValues[]

## 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

- GettyImagesServicesConnectPublicModelsEventsEventsResponse
  - `events` GettyImagesServicesConnectPublicModelsEventsEvent[], nullable
    - `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
  - `events_not_found` integer[], 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/versions/29f239eeae86/schema)