Skip to main content

How to verify Instacart+ membership and orders

Learn how to verify the Instacart+ membership status of a customer and identify Instacart+ orders.

Prerequisites​

You need the following things:

Retrieve Instacart+ membership status​

You can retrieve information about the Instacart account that is linked to the specified Connect user account.

The following request retrieves the account information of the specified user.

curl --request GET \
  --url 'https://<instacart_development_domain>/v2/fulfillment/users/kamalsingh1234/link' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>'

The response contains the membership status. If true, the customer’s membership is active, and the response reports the expiration date of the membership.

{
  "express_member": true,
  "expired_at": "2023-03-12T07:59:59Z"
}

Identify Instacart+ orders​

You can identify orders that received Instacart+ membership benefits by retrieving the order details.

The following request retrieves the order details by order ID.

curl --request GET \
  --url 'https://<instacart_development_domain>/v2/fulfillment/users/kamalsingh1234/orders/123456789-abcd' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>'

The response contains the is_express flag. If true, an Instacart+ member placed the order and the order received Instacart+ membership benefits.

{
  "id": "123456789-abcd",
  "status": "created",
  "order_url": "https://example.com/example-order",
  "created_at": "2018-02-22T00:00:00Z",
  "cancellation_reason": "shopper_driven",
  "locale": "en_US",
  "is_express": true,
  "fulfillment_details": {
    "store_location": "000-3801",
    "window_starts_at": "2018-02-22T00:00:00Z",
    "window_ends_at": "2018-02-22T00:30:00Z",
    "bag_count": 3
  },
  "items": [
    {
      "line_num": "46",
      "qty": 4,
      "qty_unit": "each",
      "replaced": false,
      "scan_code": "00070481001157",
      "replacement_policy": "shoppers_choice",
      "item": {
        "upc": "987665788999",
        "rrc": "0452-38492",
        "requested_upc": "123456789012",
        "requested_rrc": "0382-85739",
        "delivered_upc": "987665788999",
        "delivered_rrc": "0452-38492"
      }
    }
  ],
  "pos_payment_method": "UNSPECIFIED"
}
Last updated on