ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

media

Get media upload details

Get details for a registered media upload, including its current status.

Learn more about video Pin creation.

get/media/{media_id}

Path parameters

media_idstring required

Unique identifier for this media upload. Used to track status and for attaching during Pin creation.

Response

The request has succeeded.

media_idstring required

Unique identifier for this media upload. Used to track status and for attaching during Pin creation.

media_type'video' required

status'registered' | 'processing' | 'succeeded' | 'failed'

Example response

{
  "media_id": "12345"
}

Changes

Changed in 4 of the 29 revisions of this API.39

Oct 16, 2025v514c297539b6427See the full diff
- ▲
  the media_type response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the status response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 429
  response-non-success-status-added
- ○
  the response optional property media_type became not read-only for the status 200
  response-optional-property-became-not-read-only
- ○
  the response property media_id became required for the status 200
  response-property-became-required
- ○
  the response property media_type became required for the status 200
  response-property-became-required
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 12, 2022v5723c511580441See the full diff
- ○
  endpoint added
  endpoint-added
Apr 8, 2022v533ec8e7421c71See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 9, 2022v546313d0403161See the full diff
- ○
  endpoint added
  endpoint-added

Full history