1 Glossary
2 API Endpoints
3 getCategories
- 3.1 Request Parameters
- 3.2 Implementation
  - 3.2.1 Response Elements
  - 3.2.2 Example Response - JSON
  - 3.2.3 Example Response - XML
  - 3.2.4 Example Response - CSV
  - 3.2.5 Example Response - TAB
  - 3.2.6 Example Response - PIPE

Glossary

Here is the glossary of all terms that are used within this document.

Term	Abbreviation	Definition

Term	Abbreviation	Definition
Slug	Slug	The unique identifying part of a web address, typically at the end of the URL.

API Endpoints

getCategories
- Description: Use this service call to get information about categories supported by FMTC.
- Example Request: http://services.fmtc.co/v2/getCategories?key=APIKEY

getCategories

Request Parameters

Name	Value(s)	Description	Required	Default

Name	Value(s)	Description	Required	Default
key	APIKEY	API key for authentication, available on the API Keys & Calls page.(https://account.fmtc.co/cp/api_keys)	Yes	N/A, must always be provided
format	String XML, JSON, CSV, TAB, or PIPE	Choose the feed format you would like returned.	No
v2	0,1	We recently consolidated our deal types. To receive a list of our active deal types include `v2` parameter or enable V2 in your Feed Settings page.	No
view	0,1	Display feed results rather than forcing a download	No	0

Implementation

Response Elements

Name	Description

Name	Description
Slug	The unique slug assigned to the category.
Name	The human readable name of the category.
ParentID	The numerical ID of the parent category.
CategoryID	The unique numerical ID assigned to the category
Restricted	Flag value indicating if the category is a restricted-content category.

Example Response - JSON

Here is an example of a JSON Response from the getCategories endpoint.

[
    {
        "cSlug": "julyfourth",
        "cName": "4th Of July",
        "cParent": "",
        "bHoliday": "1"
    },
    {
        "cSlug": "apparel",
        "cName": "Apparel",
        "cParent": "",
        "bHoliday": "0"
    },
    {
        "cSlug": "accessories",
        "cName": "Accessories",
        "cParent": "apparel",
        "bHoliday": "0"
    }
]

Example Response - XML

Here is an example of an XML Response from the getCategories endpoint.

<?xml version="1.0" encoding="iso-8859-1" ?>
<categories>
    <category>
        <cSlug>julyfourth</cSlug>
        <name>4th Of July</name>
        <parent/>
        <holiday>1</holiday>
    </category>
    <category>
        <cSlug>apparel</cSlug>
        <name>Apparel</name>
        <parent/>
        <holiday>0</holiday>
    </category>
    <category>
        <cSlug>accessories</cSlug>
        <name>Accessories</name>
        <parent>apparel</parent>
        <holiday>0</holiday>
    </category>
    <category>
        <cSlug>apparel-baby</cSlug>
        <name>Apparel - Baby &amp; Kids</name>
        <parent>apparel</parent>
        <holiday>0</holiday>
    </category>
</categories>

Example Response - CSV

Here is an example of a CSV Response from the getCategories endpoint.

Slug,Name,Parent
julyfourth,"4th Of July",
apparel,Apparel,
accessories,Accessories,apparel

Example Response - TAB

Here is an example of a TAB Response from the getCategories endpoint.

Example Response - PIPE

Here is an example of a PIPE Response from the getCategories endpoint.

FMTC Knowledge Base

Categories - v2 (Legacy)