Categories

This method is used to obtain a MASTER CATEGORIES portfolio.

Master Categories Request

Endpoint

GET https://api.test.hotelbeds.com/transfer-cache-api/1.0/categories?fields= {{FIELDS}} &language= {{LANG}} &codes= {{CODES}} &offset= {{OFFSET}} &limit= {{LIMIT}}
TIMEOUT: 60 seconds

 

Request parameters

Name Type Description
fields String Comma separated list of response fields to return (mandatory)
language String ISO 639-1 (2 digit) Language code (mandatory)
codes String Comma separated list of Master Category codes (optional)
offset int it's the position in the dataset of a particular record. By specifying offset, you retrieve a subset of records starting with the offset value (optional)
limit int allows you to set the number of objects returned in one page (optional)

Request Example

https://api.test.hotelbeds.com/transfer-cache-api/1.0/masters/categories?fields=ALL&language=en&codes=STND

 

Master Categories Response

The response of Categories provides information of the vehicle categories used by the transfers

Response Parameters

Name Type Description
masterTransferTypeCode String Master type code the category belongs to
masterCategoryCode String Master category code
name String Name of the master category
description String Description of the master category

Response JSON Example

[
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "STND",
        "name": "Standard",
        "description": "Standard product type"
    },
    {
        "masterTransferTypeCode": "SHTL",
        "masterCategoryCode": "STND",
        "name": "Standard",
        "description": "Standard product type"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "STND",
        "name": "Standard",
        "description": "Standard product type"
    }
]

Docs Navigation