Superfiliate

List gifting rewards

Bearer authgifting_rewards.readAlpha
Alpha: This endpoint is currently in alpha and is not available to all API integrations.

Lists creator details submitted for merchant-managed gifting campaigns. Use the campaign and creator IDs to create and fulfill the gifting reward in your OMS.

GETapi.superfiliate.com/api/v1/gifting_rewards

Query parameters4

campaign_id
integer
Only return gifting rewards from this campaign
gifting_stage
string
Only return gifting rewards in this stage
page
integer
Default is 1default:1
items
integer
Default is 25 and maximum is 250default:25

Responses

A list of gifting rewards

array of objects — item fields

  • idinteger
  • gifting_stageenum<string>

    Current lifecycle stage for this reward.

    "unlocked""claimed""shipped""delivered""expired""paused""skipped""not_eligible""pending""error""ready_to_send""missing_address""order_placed""posted"

  • Program associated with this resource.

    • idinteger
    • namestring

      Human-readable name for this resource.

  • Creator associated with this resource.

    • idinteger
    • first_namestring

      Person's given name.

    • last_namestring

      Person's family name.

    • emailstring

      Email address for this person.

    • phonestring

      Phone number for this person.

  • Shipping address for this reward.

    • address1string

      First line of the shipping address.

    • address2string | null

      Second line of the shipping address, when provided.

    • citystring

      City in the shipping address.

    • country_codestring

      ISO country code in the shipping address.

    • province_codestring | null

      Province or state code in the shipping address.

    • zipstring

      Postal or ZIP code in the shipping address.

  • The selected products for this resource.

    • product_external_idstring

      Identifier for the related product external.

    • variant_external_idstring

      Identifier for the related variant external.

    • product_titlestring

      The product title for this resource.

    • variant_titlestring

      The variant title for this resource.

    • image_urlstring | null

      URL for image.

    • skustring | null

      The sku for this resource.

    • The options for this resource.

      • namestring

        Human-readable name for this resource.

      • valuestring

        The value for this resource.

    • quantityinteger

      The quantity for this resource.

    • selected_atstring

      ISO 8601 timestamp for selected.

  • The fulfillment for this resource.

    • external_order_idstring | null

      Identifier for the related external order.

    • carrierstring | null

      The carrier for this resource.

    • tracking_numberstring | null

      The tracking number for this resource.

    • tracking_urlstring | null

      URL for tracking.

    • fulfilled_atstring

      ISO 8601 timestamp for fulfilled.

  • details_submitted_atstring

    ISO 8601 timestamp for details submitted.

  • created_atstring

    ISO 8601 timestamp when this resource was created.

  • updated_atstring

    ISO 8601 timestamp when this resource was last updated.