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

ads

Get ad

Changed on Jun 4, 2026

Get a specific ad given the ad ID. If your pin is rejected, rejected_reasons will contain additional information from the Ad Review process. For more information about our policies and rejection reasons see the Pinterest advertising standards.

get/ad_accounts/{ad_account_id}/ads/{ad_id}

Request

Base URL
https://api.pinterest.com/v5
Auth
- OAuth 2
  Authorization codehttps://www.pinterest.com/oauth/
  Token URLhttps://api.pinterest.com/v5/oauth/token
  Scopesads:read
- or OAuth 2
  Client credentials
  Token URLhttps://api.pinterest.com/v3/oauth/access_token/
  Scopesads:read
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ads/:ad_id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

ad_idstring required

The ID of this ad.

ad_account_idstring required

Unique identifier of an ad account.

Response

The request has succeeded.

ad_account_idstring required

The ID of the advertiser that this ad belongs to.

ad_group_idstring required

ID of the ad group that contains the ad.

android_deep_linkstring nullable

Deep link URL for Android devices.

campaign_idstring required

ID of the ad campaign that contains this ad.

carousel_android_deep_linksstring[] nullable

Comma-separated deep links for the carousel pin on Android.

carousel_destination_urlsstring[] nullable

Comma-separated destination URLs for the carousel pin to promote.

carousel_ios_deep_linksstring[] nullable

Comma-separated deep links for the carousel pin on iOS.

carting_platform_typeinteger

The vendor platform type of the carting ad. 1 for MIKMAK, 2 for PEAR.

click_tracking_urlstring nullable

Tracking url for the ad clicks.

collection_items_destination_url_templatestring nullable

Destination URL template for all items within a collections drawer.

collections_header_type'SHOP_THIS_COLLECTION' | 'EXPLORE_THIS_COLLECTION' | 'NO_HEADER' | 'null' nullable

Collections ad header type for ads

created_timeinteger

Pin creation time. Unix timestamp in seconds.

Ad creative type enum. Note: SHOP_THE_PIN has been deprecated. Please use COLLECTION instead.

Select a call to action (CTA) to display below your ad. Available only for ads with direct links enabled. CTA options for consideration and conversion campaigns are LEARN_MORE, SHOP_NOW, BOOK_NOW, SIGN_UP, VISIT_SITE, BUY_NOW, GET_OFFER, ORDER_NOW, ADD_TO_CART (for conversion campaigns with add to cart conversion events only)

destination_urlstring nullable

Destination URL.

Type of information in the page referenced by disclosure_url, provided either by the Food and Drug Administration (FDA) or the manufacturer.

disclosure_urlstring nullable

URL for a page that provides disclosures about a pharmaceutical product, such as potential side effects. Make sure the URL takes the user directly to the disclosure content and the referenced site is secure.

grid_click_type'CLOSEUP' | 'DIRECT_TO_DESTINATION' nullable

Where a user is taken after clicking on an ad in grid.

Note: This parameter is read-only and is set to DIRECT_TO_DESTINATION by default for direct links supported ads. grid_click_type values provided will be ignored.

idstring required

The ID of this ad.

ios_deep_linkstring nullable

Deep link URL for iOS devices.

is_cartingboolean

Is the ad a carting/WTB ad?

is_collage_accepted_termsboolean

Whether the advertiser has accepted the terms and conditions for collage ad.

is_collage_single_destinationboolean

Whether the collage ad has a single destination url override.

is_pin_deletedboolean

Is original pin deleted?

is_removableboolean

Is pin repinnable?

lead_form_idstring nullable

Lead form ID for lead ad generation.

namestring nullable

Name of the ad - 255 chars max.

pin_idstring required

Pin ID. This field may only be updated for draft ads.

rejected_reasonsAdDisapprovalReasons[] required

Enum reason why the pin was rejected. Returned if review_status is "REJECTED".

rejection_labelsstring[] required

Text reason why the pin was rejected. Returned if review_status is "REJECTED".

review_status'OTHER' | 'PENDING' | 'REJECTED' | 'APPROVED' required

Ad review status

status'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'DELETED_DRAFT'

Entity status

Summary status for pin promotions

typestring required

Always "ad".

updated_timeinteger

Last update time. Unix timestamp in seconds.

view_tracking_urlstring nullable

Tracking URL for ad impressions.

Example response

{
  "collections_header_type": "SHOP_THIS_COLLECTION",
  "customizable_cta_type": "LEARN_MORE",
  "disclosure_type": "MED_GUIDE",
  "grid_click_type": "CLOSEUP",
  "quiz_pin_data": {
    "questions": [
      {
        "question_id": 1,
        "question_text": "Where do you thrive?",
        "options": [
          {
            "text": "Hangout vibes"
          },
          {
            "text": "Time to party!"
          },
          {
            "text": "Keeping it lowkey"
          }
        ]
      },
      {
        "question_id": 2,
        "question_text": "Where would you nap?",
        "options": [
          {
            "text": "Hammock in the mountains"
          },
          {
            "text": "Beach towel in the sand"
          },
          {
            "text": "Tent under the stars"
          }
        ]
      },
      {
        "question_id": 2,
        "question_text": "Who are you taking?",
        "options": [
          {
            "text": "No one—solo trip!"
          },
          {
            "text": "My best friend"
          },
          {
            "text": "The family"
          }
        ]
      }
    ],
    "results": [
      {
        "organicPinId": "1234",
        "android_deep_link": "https://www.pinterest.com/",
        "iOS_deep_link": "https://www.pinterest.com/",
        "destination_url": "https://www.pinterest.com/",
        "result_id": 1
      },
      {
        "organicPinId": "1234",
        "android_deep_link": "https://www.pinterest.com/",
        "iOS_deep_link": "https://www.pinterest.com/",
        "destination_url": "https://www.pinterest.com/",
        "result_id": 2
      },
      {
        "organicPinId": "1234",
        "android_deep_link": "https://www.pinterest.com/",
        "iOS_deep_link": "https://www.pinterest.com/",
        "destination_url": "https://www.pinterest.com/",
        "result_id": 3
      }
    ]
  },
  "status": "ACTIVE",
  "summary_status": "APPROVED",
  "tracking_urls": {
    "impression": [
      "URL1",
      "URL2"
    ],
    "click": [
      "URL1",
      "URL2"
    ],
    "engagement": [
      "URL1",
      "URL2"
    ],
    "buyable_button": [
      "URL1",
      "URL2"
    ],
    "audience_verification": [
      "URL1",
      "URL2"
    ]
  }
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- info
  removed subschema #3 from the response body allOf list for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Dec 11, 2025v5537bde5a50b1 Revision changes
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status

Operation history (13 revisions)