Experiment with this API

Get Partner Channels

Retrieves a list of channel data.


You'll need an API key and a Resource Owner Grant access token to use this resource. Please see our Getting Started page for more information on how to sign up for an API key.

Use the following endpoint to get channels:

GET https://api.gettyimages.com/v3/asset-changes/channels

Add your API key and the Resource Owner Grant access token to the request header:

Api-Key: <your api key>
Authorization: Bearer <your secure access token>

Your request would look like this using curl:

    curl -X GET 
    -H "Api-Key: <your api key>" 
    -H "Authorization: Bearer <your-token>" 

The response body will look like the following example:

  "Channels": [
      "AssetFamily": "",
      "ChannelId": 0,
      "ChannelType": "",
      "StartDate": ""

Only channels that have been queried in the last 120 days will be included in the list of channels. Partners who have a channel that has been removed should contact their sales representative to be set up again.

Request Headers

Api-Key string Api-Key Required.
Accept-Language string Accept-Language parameter optional. Used to restrict the set of natural languages that are preferred as a response to the request.
Authorization string Authorization token required. Used for applying content access restrictions. Use one of the OAuth2 grants to auto-populate this value. Required.

Response Body Fields


Channels array [ PartnerChannel ]


AssetFamily string Specifies the asset family for the channel (e.g. "editorial" or "creative")
ChannelId integer Specifies the identification number for the channel
ChannelType string Specifies the channel type (i.e. "New," "Updated" or "Deleted")
StartDate string
NotificationCount integer Specifies the current count of notifications pending in the channel