Documentation
Feedback
Guides

Introduction

Every API in this reference gets its own category listed in the menu to the left. Endpoints are listed individually but grouped by function and get an icon to identify the request method (GET, POST, PUT, DELETE) used.

{"base64":"  ","img":{"width":1019,"height":933,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":92871,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-0.png"}}

accountName & environment

You can set the accountName variable to test requests with your own account or use the apiexamples test account. The environment variable can be set to either vtexcommercestable or vtexcommercebeta.

{"base64":"  ","img":{"width":406,"height":478,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":240892,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-1.gif"}}

Code samples

The reference will provide copy-paste-ready samples for making requests to our APIs. You can select different languages, and the code will be updated as you input different parameters and set your authentication settings.

{"base64":"  ","img":{"width":392,"height":386,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":16773,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-2.png"}}

Parameter List

In the Body params section, you will find all possible parameters for the current endpoint, as well as their types.

{"base64":"  ","img":{"width":578,"height":337,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":18985,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-3.png"}}
You can input values for each parameter in the text boxes to the right and watch the code be updated in real time.
{"base64":"  ","img":{"width":1018,"height":482,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":88000,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-4.gif"}}

Try It

Click on the Try It button to send the request right from the browser and see the server's response.

{"base64":"  ","img":{"width":65,"height":35,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":733,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-5.png"}}

Authentication

To make requests to VTEX APIs you will need to input certain variables to the request's Header. Read more about it here.

{"base64":"  ","img":{"width":429,"height":161,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":6345,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-6.png"}}

Response

To check the response fields and definitions, click on the response status to expand the endpoint’s response body.

{"base64":"  ","img":{"width":580,"height":110,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":3967,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-7.png"}}

{"base64":"  ","img":{"width":608,"height":871,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":33371,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-8.png"}}
To check a response body example, click on Examples and select one of the listed examples.
{"base64":"  ","img":{"width":406,"height":446,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":55007,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/get-to-know-vtex-apis-9.gif"}}

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page