Skip to main content

Get Cross-sell

Retrieve one complete cross-sell by id.

Live get is flat. Draft get is nested under the owner product. An offer still being set up returns 404 — see Incomplete items.

Request

Live:

  • GET /cross-sells/{id}

Draft:

  • GET /products/{productId}/draft/cross-sells/{id}

There is no live nested GET /products/{productId}/cross-sells/{id}.

Path Parameters

ParameterTypeRequiredDescription
productIdstringDraft onlyOwner product UUID.
idstringYesCross-sell UUID.

Example Request

curl -X GET "https://cart.easy.tools/api/v1/cross-sells/37643a70-be0f-4f09-ae36-c36e3ddb35dc" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success Response (200)

{
"id": "37643a70-be0f-4f09-ae36-c36e3ddb35dc",
"product_id": "70dbd819-fac2-4dcf-b655-fb925e24410b",
"variant_id": "5272bfcf-4e92-458d-b513-80ca474a16e4",
"parent_id": null,
"title": "Add the workbook",
"main_description": null,
"description": null,
"button_text": "Yes, add it",
"amount": 4900,
"currency": "usd",
"discount": null,
"validity_minutes": 15,
"one_purchase": true,
"send_offer": true,
"active": true
}

See Cross-sell Object.

Error Responses

Bad Request (400)

{
"message": "Invalid cross-sell ID"
}

Not Found Error (404)

Unknown owner product, unknown cross-sell, or an incomplete overlay item:

{
"message": "Cross-sell with ID 37643a70-be0f-4f09-ae36-c36e3ddb35dc not found"
}

Unauthorized Error (401)

{
"message": "Unauthenticated."
}

Forbidden Error (403)

{
"message": "You do not have API access to the requested store."
}