Skip to main content

Get Instacart account information

GET /v2/fulfillment/users/{user_id}/link

Retrieves information about the Instacart account that is linked to the specified Connect user account. The response contains the status of the Instacart+ membership. If true, the response also reports the expiration date of the membership.

Security

NameInDescription
AuthorizationheaderThe Authorization header with the bearer token acquired during authentication.

Parameters

NameInTypeRequiredDescription
user_idpathstringRequiredThe ID of the user.

Request

None.

Request examples

curl --request GET \
--url 'https://connect.instacart.com/v2/fulfillment/users/{user_id}/link' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Response

FieldTypeRequiredDescription
express_memberbooleanOptionalDeprecated. Use 'instacartplus_member' instead.
instacartplus_memberbooleanRequiredIndicates whether the linked user is an Instacart+ member.
expired_atstringOptionalThe time of expiration of current Instacart+ subscription, if exists.

Response examples

200 Success

{
"express_member": true,
"instacartplus_member": true,
"expired_at": "2021-06-30T04:00:00Z"
}

4XX Errors

Error responses return either a single error or multiple errors.

HTTP CodeCauseError MessageError CodeError Meta
400User not found"User Not Found"1001{"key":"user_id"}
400User not linked"User Not Linked"1001{"key":"user_id"}
403User not active"User Not Active"nullNot applicable