GOgorest
Shop

Create a cart

post/carts

Request

  • Base URL
    https://gorest.co.in/public/v3
  • URL
    https://gorest.co.in/public/v3/carts
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

A unique key (a UUID is fine) that makes a POST safe to retry for 24 hours. A retry with the same key, path and body gets the first answer again with Idempotent-Replayed: true and creates nothing; a retry while the first is still running gets 409 conflict with Retry-After: 1. The same key with another request gets 422 idempotency_key_mismatch. Only a 2xx answer is kept, so after an error the retry runs again. An answer over 64 KiB, or one that holds a new token's value, is not kept: its retry gets 409 conflict with the Location of what the first request made.

Request body

currencystring required

An ISO 4217 code, either case.

user_idstring uuid required

A user you can see with no active cart.

Response

The new cart.

created_atstring date-time
currencystring

Every line is in this currency. Fixed once the cart is made.

idstring uuid required
read_onlyboolean

True for sample data (the seed); it cannot be changed.

status'active' | 'abandoned' | 'ordered'

ordered is set by placing an order and is final.

updated_atstring date-time
user_idstring uuid

Whose cart; a user you can see. One active cart per user.

Example response

{
  "currency": "INR",
  "items": [
    {
      "product": {
        "category": {
          "name": "Home and kitchen",
          "slug": "home-kitchen"
        },
        "currency": "INR",
        "name": "Wireless earbuds",
        "price_minor": 249900,
        "sku": "EL-1001"
      }
    }
  ],
  "user": {
    "email": "aarav.sharma@example.com",
    "name": "Aarav Sharma"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.