Get Category

get

https://sellercenter-api.falabella.com/?Action=GetCategoryTree

GetCategoryTree

This API retrieves the list of all existing categories.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

The response from this endpoint contains the "Categories" collection, which includes category resources recursively. It is important to note that Falabella only allows product creation at the last category level; uploading products to intermediate levels is not permitted.
Each category consists of the following fields:

Name	Type	Description
Name	String	The name of the category
GlobalIdentifier	String	A unique identifier for this category across all countries
CategoryId	Integer	The ID of the category
AttributeSetId	Integer	The ID of the AttributeSet to be used in other API calls (i.e., GetCategoriesByAttributeSet)
Children	Node	List of all subcategories (category resources)

Errors

No specific errors.

Query Params

Action

string

Defaults to GetCategoryTree

Name of the function to be called. Mandatory and must be 'GetCategoryTree' in this case. If omitted, an error 'E001: Parameter Action is mandatory' is returned. If an unknown function string is provided, an error message 'E008: Invalid Action' is returned.

Format

string

Defaults to XML

If provided, it must be 'JSON' or 'XML'. If not provided, 'XML' is assumed.

Timestamp

date

The current time in ISO8601 format relative to UTC (e.g., timestamp = 2015-04-01T10:00:00+02:00 for Berlin), so that calls cannot be replayed by a third party spying (i.e., calls that are too far in the past or future produce an error message). Mandatory. If not provided, the error message 'E001: Parameter timestamp is mandatory' appears. If the timestamp is too old or in the future, an error message 'E003: Timestamp has expired' is returned.

UserID

string

The ID of the user making the call. The list of authorized users is maintained in the Seller Center web interface under General Settings / Manage Users.

Version

string

The API version against which this call will be executed, in major.minor.patch format. It must currently be 1.0, even though the actual API version is 2.6.20. If omitted, the error message "E001: Parameter Versio

Signature

string

The cryptographic signature that authenticates the request. A caller must create this value by calculating the SHA256 hash of the request using the API key of the user specified in the UserID parameter. Mandatory. If omitted, the error message "E001: Parameter Signature is man

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Errors

200200

400400