# Product Categories

## zapiGetMerchandiseCategories

<mark style="color:blue;">`GET`</mark> `https://{yourdomainname}.zaui.net/zapi/`

#### Request Body

| Name                                            | Type    | Description                                                                     |
| ----------------------------------------------- | ------- | ------------------------------------------------------------------------------- |
| zapiToken<mark style="color:red;">\*</mark>     | integer | Token that must be used for a reseller to communicate with the supplier system. |
| methodName<mark style="color:red;">\*</mark>    | string  | The method being called.                                                        |
| zapiUserId<mark style="color:red;">\*</mark>    | integer | Generated by the supplier system when a new contact is created.                 |
| zapiAccountId<mark style="color:red;">\*</mark> | integer | Generated by the supplier system.                                               |

{% tabs %}
{% tab title="200: OK " %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
    <zapiVersion>2.1</zapiVersion>
    <error>0</error>
    <message>OK</message>
    <methodResponse>
        <methodName>zapiGetMerchandiseCategories</methodName>
        <methodErrorCode>0</methodErrorCode>
        <methodErrorMessage/>
        <categories>
            <category>
                <categoryId>1</categoryId>
                <categoryName>
                    <![CDATA[Shirts]]>
                </categoryName>
                <categoryDescription>
                    <![CDATA[]]>
                </categoryDescription>
                <numberOfProducts>1</numberOfProducts>
            </category>
            <category>
                <categoryId>2</categoryId>
                <categoryName>
                    <![CDATA[Ski Poles]]>
                </categoryName>
                <categoryDescription>
                    <![CDATA[]]>
                </categoryDescription>
                <numberOfProducts>1</numberOfProducts>
            </category>
        </categories>
    </methodResponse>
</response>
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Request" %}

```xml
<request>
	<zapiToken></zapiToken>
	<zapiAccountId></zapiAccountId>
	<zapiUserId></zapiUserId>
	<zapiMethod>
		<methodName>zapiGetMerchandiseCategories</methodName>
	</zapiMethod>
</request>
```

{% endtab %}

{% tab title="Response" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
	<zapiVersion>2.0</zapiVersion>
	<error>0</error>
	<message>ZAPI Ok</message>
	<methodResponse>
		<methodName>zapiGetMerchandiseCategories</methodName>
		<categories>
			<category>
				<categoryId></categoryId>
				<categoryName></categoryName>
				<categoryDescription></categoryDescription>
			</category>
		</categories>
	</methodResponse>
</response> 
```

<table><thead><tr><th width="221" align="center">Element</th><th width="150" align="center">M/O/C</th><th width="150" align="center">Format</th><th width="150" align="center">Length</th><th align="center">Details</th></tr></thead><tbody><tr><td align="center"><strong>Response</strong></td><td align="center">M</td><td align="center">a-z, A-Z</td><td align="center"></td><td align="center">Top level element</td></tr><tr><td align="center"><strong>ZapiVersion</strong></td><td align="center">M</td><td align="center">0-9</td><td align="center">5</td><td align="center"></td></tr><tr><td align="center"><strong>Error</strong></td><td align="center">M</td><td align="center">0-9</td><td align="center">2</td><td align="center">Error message details</td></tr><tr><td align="center"><strong>Message</strong></td><td align="center">M</td><td align="center">a-z, A-Z, 0-9</td><td align="center">Variable</td><td align="center"></td></tr><tr><td align="center"><strong>MethodResponse</strong></td><td align="center">M</td><td align="center"></td><td align="center"></td><td align="center"></td></tr><tr><td align="center"><strong>MethodName</strong></td><td align="center">M</td><td align="center">a-z, A-Z, 0-9</td><td align="center">Variable</td><td align="center">See documentation for options</td></tr><tr><td align="center"><strong>Items</strong></td><td align="center">M</td><td align="center">Element</td><td align="center">Variable</td><td align="center"></td></tr><tr><td align="center"><strong>Item</strong></td><td align="center"></td><td align="center">Element</td><td align="center">Variable</td><td align="center"></td></tr><tr><td align="center"><strong>CategoryID</strong></td><td align="center">M</td><td align="center">0-9</td><td align="center"></td><td align="center">Unique ID for the category</td></tr><tr><td align="center"><strong>CategoryName</strong></td><td align="center">M</td><td align="center">a-z, A-Z, 0-9</td><td align="center"></td><td align="center">Category name</td></tr><tr><td align="center"><strong>Category Description</strong></td><td align="center">M</td><td align="center">a-z, A-Z, 0-9</td><td align="center">Variable</td><td align="center">Category description</td></tr></tbody></table>
{% endtab %}
{% endtabs %}
