Creating a basket

The first thing you need to do is to attach your AccessToken token to the request's header. See Quick Start if you are not sure how to do that.

To create new basket your request should have a body with:

• CultureCode
• Currency

An example could be:

    
        curl -D- -X POST https://umbracodemo1.ucommerce.net/api/v1/baskets \
            -H 'Authorization: Bearer <ACCESS_TOKEN>' 
            -H 'Content-Type: application/json' \
            -d '{
                    "cultureCode": "en-US",
                    "currency": "DKK"
                }'
    

If you get a successful response, the newly created basketId will be returned back to you.

Example:

    
    {
        "basketId": "afd095a8-6215-4daf-a813-60f27f01c7b7"
    }
    

Possible errors that may occur:

Example:

    
    {
        "errors": [
            {
                "error-description": "Currency does not exist.",
                "error": "BadRequest"
            }
        ]
    }
    

See Handling failures for more info.