Documentation

Categories

This method is used to obtain a MASTER CATEGORIES portfolio.

Master Categories Request

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

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.hotelbeds.com/transfer-cache-api/1.0/ masters/categories?fields=ALL&language=en

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 Example

[
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "ECO",
        "name": "Economy",
        "description": "Economy"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "ECO",
        "name": "Economy",
        "description": "Economy"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "ECON",
        "name": "Economy",
        "description": "Economy"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "EPL",
        "name": "Employee",
        "description": "Employee product type"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "EXPRS",
        "name": "Express",
        "description": "Express product type"
    },
    {
        "masterTransferTypeCode": "SHTL",
        "masterCategoryCode": "EXPRS",
        "name": "Express",
        "description": "Express product type"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "LXR",
        "name": "Luxury",
        "description": "Luxury product type"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "PRM",
        "name": "Premium",
        "description": "Premium product type"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "PRM",
        "name": "Premium",
        "description": "Premium product type"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "PRMEWT",
        "name": "Premium Extended Wait Time",
        "description": "Premium Extended Wait Time"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "PRMEWT",
        "name": "Premium Extended Wait Time",
        "description": "Premium Extended Wait Time"
    },
    {
        "masterTransferTypeCode": "SHTL",
        "masterCategoryCode": "SPCL",
        "name": "Special",
        "description": "Special product type"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "SPCL",
        "name": "Special",
        "description": "Special product type"
    },
    {
        "masterTransferTypeCode": "SHRD",
        "masterCategoryCode": "SPCL",
        "name": "Special",
        "description": "Special product type"
    },
    {
        "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"
    },
    {
        "masterTransferTypeCode": "PRVT",
        "masterCategoryCode": "STNDEWT",
        "name": "Standard Extended Wait Time",
        "description": "Standard Extended Wait Time"
    }
]