Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Info

The file data is cached and new request for the file once an hour should be suitable for those looking to accurately recreate the Betfair navigation menu.

The following request headers are required:

  • X-Application  - Your Application Key

  • X-Authentication Your session token, obtained from the API login response.

...

Code Block
GET https://api.betfair.com/exchange/betting/rest/v1/en/navigation/menu.json
Connection: keep-alive
X-Application: <AppKey>
X-Authentication: <SessionToken>
Accept: application/json
Accept-Encoding: gzip,deflate

...

The following languages are supported by the navigation file:

en | en_GB | da | de | es | it | pt | ru | sv

English - en

Spanish - es

Italian  - it

German - de

Swedish - sv

Portuguese  -pt

Russian - ru

Danish - da

...

This is a diagram showing how the Navigation Data File is structured.

...

In plain English:

ROOT group node has one or many EVENT_TYPE nodes

An EVENT_TYPE node has zero, one or many GROUP nodes

An EVENT_TYPE node has zero, one or many EVENT nodes

A Horse Racing EVENT_TYPE node has zero, one or many RACE nodes

RACE node has one or many MARKET nodes

GROUP node has zero, one or many EVENT nodes

GROUP node has zero, one or many GROUP nodes

An EVENT node has zero, one or many MARKET nodes

An EVENT node has zero, one or many GROUP nodes

An EVENT node has zero, one or many EVENT nodes

...

{

    "children": [

        {

            EVENT_TYPE1

        },

        {

            EVENT_TYPE2

        },

        ...

    ],

    "id": 0, // always 0

    "name": "ROOT", // always ROOT

    "type": "GROUP" // always GROUP

}

...

{

    "children": [

        {

            GROUP or EVENT or RACE (RACE only if Greyhounds/Horse Racing)

        },

        ...

    ],

    "id": "1", // Betfair specific eventTypeId

    "name": "Soccer",

    "type": "EVENT_TYPE"

}

...

{

    "children": [

        {

            GROUP or EVENT

        },

        ...

    ],

    "id": "74568202414", // Not a Betfair specific id, different for every GROUP

    "name": "Womens Soccer",

    "type": "GROUP"

}

...

{

    "children": [

        {

            GROUP, MARKET or EVENT

        },

        ...

    ],

    "id": "27244118", // Betfair specific eventId

    "name": "South Korea U20 (W) v Mexico U20 (W)",

    "countryCode": "GB",

    "type": "EVENT"

}

...

{

    "children": [

        {

            MARKET

        },

        ...

    ],

    "id": "27247020.1115", // Betfair specific raceId

    "name": "1300m 3yo",

    "startTime": "2014-08-12T11:15:00.000Z",

    "type": "RACE",

    "venue": "Deauville",

"raceNumber" : "R1", // US specific information about race numbers

    "countryCode": "GB"

}

...

{  

    "exchangeId": "1", // Betfair specific exchangeId

    "id": "1.114881860", // Betfair specific marketId

    "marketStartTime": "2014-08-14T00:00:00.000Z", // Betfair specific marketStartTime

    "marketType": "WIN", // Betfair specific marketType (e.g. PLACE, WIN, FORECAST etc.)

    "numberOfWinners": "2", // Betfair specific number of winners

    "name": "Over/Under 6.5 Goals",

    "type": "MARKET"

}

{"id":"EJyr1dNQxAJdJguiodbJA","name":"page","children":[{"id":"iOCUkGtPzoYzSRQ_IZAXO","params":{"background":{"light":"#ffffff99","dark":"#1d212599"},"padding":20,"gap":10,"backgroundSize":"contain","image":{"value":"att19398657","target":"_blank","type":"attachment"}},"children":[],"name":"section"},{"params":{"padding":0,"gap":0,"image
Appanvil karma designer
summary Home | API Status | Historical Data | Vendor Program | Developer Forum Navigation Data For Applications
page

Endpoint & Required Headers

...

ExampleExample Request

...

Supported Locales

...

Navigation Data File Structure

...

JSON Model Structure

...

This Navigation Data for Applications service allows the retrieval of the full Betfair market navigation menu from a compressed file. 

...

Exchange

...

HTTP Method

...

Endpoint

...

UK

...

GET

...

https://api.betfair.com/exchange/betting/rest/v1/en/navigation/menu.json

...

ITALY

...

GET

...

https://api.betfair.it/exchange/betting/rest/v1/it/navigation/menu.json

...

SPAIN

...

GET

...

https://api.betfair.es/exchange/betting/rest/v1/es/navigation/menu.json

Appanvil karma designer
summary Home | API Status | Historical Data | Vendor Program | Developer Forum Navigation Data For Applications
page{"id":"EJyr1dNQxAJdJguiodbJA","name":"page","children":[{"id":"iOCUkGtPzoYzSRQ_IZAXO","params":{"background":{"light":"#ffffff99","dark":"#1d212599"},"padding":20,"gap":10,"backgroundSize":"contain","image":{"value":"att19398657","target":"_blank","type":"attachment"}},"children":[],"name":"section"},{"params":{"padding":0,"gap":0,"image":{"value":"https://images.unsplash.com/photo-1554034483-04fda0d3507b?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzMzg3MzF8MHwxfHNlYXJjaHw2fHxncmFkaWVudHxlbnwwfDB8fHwxNzAyMzkyMDI1fDA&ixlib=rb-4.0.3&q=80&w=1080","target":"_self","type":"link"},"background":{"type":"solid","dark":"#1D2125","light":"#000000"}},"children":[{"name":"row","children":[{"name":"column","children":[{"name":"text","params":{"templateId":"headline 2","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"text":"","fontSize":18},{"type":"link","link":{"value":"https://betfair-developer-docs.atlassian.net/wiki/spaces/1smk3cen4v3lu3yomq5qye0ni/overview","target":"_blank","type":"link"},"children":[{"text":"Home","letterSpacing":0,"fontFamily":"Poppins, sans-serif","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":" | ","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://status.developer.betfair.com/","target":"_blank","type":"link"},"children":[{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":"API Status ","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":"| ","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://imageshistoricdata.unsplashbetfair.com/photo-1554034483-04fda0d3507b?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzMzg3MzF8MHwxfHNlYXJjaHw2fHxncmFkaWVudHxlbnwwfDB8fHwxNzAyMzkyMDI1fDA&ixlib=rb-4.0.3&q=80&w=1080","","target":"_selfblank","type":"link"},"backgroundchildren":[{"typeletterSpacing":"solid"0,"darkfontFamily":"#1D2125Poppins, sans-serif","lightbackgroundColor":{"#000000"}}type":"solid","childrenlight":[{"name"#000000"},"text":"rowHistorical Data","childrencolor":[{"nametype":"columnsolid","childrenlight":[{"name#ffffff":},"textfontSize":18}]},{"paramsletterSpacing":{0,"templateIdfontFamily":"headline 2Poppins, sans-serif","valuebackgroundColor":[{"type":"paragraphsolid","childrenlight":[{"type#000000"},"text":" paragraph| ","childrencolor":[{"text{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://betfair-developer-docs.atlassianbetfair.netcom/wikien/spaces/1smk3cen4v3lu3yomq5qye0ni/overviewvendor-program/the-process/","target":"_blank","type":"link"},"children":[{"text":"Home","letterSpacing":0,"fontFamily":"Poppins, sans-serif","backgroundColor":{"type":"solid","light":"#000000"},"text":"Vendor Program","color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":" | ","backgroundColor":{"type":"solid","light":"#000000"},"colortext":" | ","color":{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://statusforum.developer.betfair.com/","target":"_blank","type":"link"},"children":[{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":"API Status Developer Forum","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"letterSpacingtext":0""}],"fontFamilyalign":"Poppins, sans-serif","text"center"}]}]},"children":[],"id":"| CO2FLq4NeFdddoCtq1lBg"}],"backgroundColorparams":{"typeborderRadius":{"solidall":0,"lightbtl":"#000000"}0,"colorbbl":{0,"typebtr":"solid"0,"lightbbr":"#ffffff"}0,"fontSizeisIndividualCorners":18false},{"typepadding":"link"0,"linkgap":{20,"valueverticalAlignment":"https://historicdata.betfair.com/"top"},"targetid":"_blankrJ16aA1aMkr8JRkTqLleH"},{"typename":"linkcolumn"},"children":[],"params":{"letterSpacingborderRadius":{"all":0,"fontFamilybtl":"Poppins, sans-serif"0,"bbl":0,"backgroundColorbtr":{0,"typebbr":"solid"0,"lightisIndividualCorners":"#000000"false},"textpadding":"Historical Data"0,"colorgap":{20,"typeverticalAlignment":"solidtop"},"lightid":"#ffffff7fUpJjIL2DsfQknnq-wa0"},{"fontSizename":18}]},{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","backgroundColor":{"type":"solid","light":"#000000"},"text":" | ","color":{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://developer.betfair.com/en/vendor-program/the-process/","target":"_blank","type":"link"},"children":[{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","backgroundColor":{"type":"solid","light":"#000000"},"text":"Vendor Program","color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","backgroundColor":{"type":"solid","light":"#000000"},"text":" | ","color":{"type":"solid","light":"#ffffff"},"fontSize":18},{"type":"link","link":{"value":"https://forum.developer.betfair.com/","target":"_blank","type":"link"},"children":[{"letterSpacing":0,"fontFamily":"Poppins, sans-serif","text":"Developer Forum","backgroundColor":{"type":"solid","light":"#000000"},"color":{"type":"solid","light":"#ffffff"},"fontSize":18}]},{"text":""}],"align":"center"}]}]},"children":[],"id":"CO2FLq4NeFdddoCtq1lBg"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"rJ16aA1aMkr8JRkTqLleH"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"7fUpJjIL2DsfQknnq-wa0"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"PIPX4pcmcW98Txau_w0mN"},{"name":"column""column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"PIPX4pcmcW98Txau_w0mN"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"cCTICr9-WCCKgM1zihI3a"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"7tcYt28H6ZBQHonx-iXCM"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"uu1DjQWXgO_NO5oXOAHWf"}],"params":{"layout":[1],"gap":10,"minHeight":10,"padding":25,"borderRadius":0,"backgroundColor":{"light":"#000000","dark":"#1C2124"},"size":"full"},"id":"w72_YQeLVmnO_3H7W5tTY"}],"name":"section","id":"x_1tr1IPoFQQqIJn_2Jii"},{"id":"xq8go2x2nzRB53Gl6mcmu","params":{"background":{"light":"#ffc40099","dark":"#1d21259999"},"padding":0,"gap":10,"image":{"value":"att21397505","target":"_blank","type":"attachment"}},"children":[{"id":"SwCvX77I8YzeID8el1Ux2","name":"row","children":[{"id":"dZPbWKV2EsN6n_Qs5Y85N","name":"column","children":[{"name":"text","params":{"templateId":"headline and paragraph","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"text":"Navigation Data For Applications","fontWeight":700,"letterSpacing":-3,"lineHeight":"64px","color":{"light":"#000000","dark":"#ffffff"},"fontFamily":"unset","fontSize":48}],"align":"center"}]}]},"children":[],"paramsid":{"borderRadius"0TtmjnO-f4xz9ArW2UWHv"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":2040,"verticalAlignment":"top"}},{"id":"cCTICr9-WCCKgM1zihI3a"},{5gTC-wLx6Abt7H_z-FUDj","name":"column","children":[]{"name":"image","params":{"borderRadiustemplateId":{"allfull-width":0,"btlalignment":0"center","bblposition":0,"btrcenter center":0,"bbrborderRadius":0,{"isIndividualCornersall":false}10,"paddingbbl":0,"gapbbr":200,"verticalAlignmentbtl":"top"}0,"idbtr":"7tcYt28H6ZBQHonx-iXCM"},{"name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":20,"verticalAlignment":"top"},"id":"uu1DjQWXgO_NO5oXOAHWf"}],"params":{"layout":[1],"gap":10,"minHeight":10,"padding":25,"borderRadius":0,"backgroundColor":{"light":"#000000","dark":"#1C2124"},"size":"full"},"id":"w72_YQeLVmnO_3H7W5tTY"}],"name":"section","id":"x_1tr1IPoFQQqIJn_2Jii"},{"id":"xq8go2x2nzRB53Gl6mcmu","params":{"background":{"light":"#ffc40099","dark":"#1d21259999"},"padding":16,"gap":10,"image":{"value":"att21397505","target":"_blank","type":"attachment"}},"children":[{"id":"SwCvX77I8YzeID8el1Ux2","name":"row","children":[{"id":"dZPbWKV2EsN6n_Qs5Y85N","name":"column","children":[{"name":"text","params":{"templateId":"headline and paragraph","value":[{"type":"paragraph","children":[{"type":"paragraph","children":[{"text":"Navigation Data For Applications","fontWeight":700,"letterSpacing":-3,"lineHeight":"64px","color":{"light":"#000000","dark":"#ffffff"},"fontFamily":"unset","fontSize":48}],"align":"center"}]}]},"children":[],"id":"0TtmjnO-f4xz9ArW2UWHv"}0,"isIndividualCorners":false},"image":{"value":"https://images.unsplash.com/photo-1524758631624-e2822e304c36?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzMzg3MzF8MHwxfHNlYXJjaHw4fHxPZmZpY2V8ZW58MHx8fHwxNjkzNTYzNzQ1fDA&ixlib=rb-4.0.3&q=80&w=1080","target":"_self","type":"link"}},"children":[],"id":"I9mL3DVNDAKTji5vQM2F7"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"sJ_W6Nh8Xt4FguMmSMhQR","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"YrSohHBn4-xI7LMUQezzu","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"3pjGIxBYtledL6ItUdDL8","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"m8F56VGx_TDGDmXAo3-XI","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"5gTC-wLx6Abt7H_z-FUDj","name":"column","children":[{"name":"image","params":{"templateId":"full-width","alignment":"center","position":"center center","borderRadius":{"all":10,"bbl":0,"bbr":0,"btl":0,"btr":0,"isIndividualCorners":false},"image":{"value":"https://images.unsplash.com/photo-1524758631624-e2822e304c36?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3wzMzg3MzF8MHwxfHNlYXJjaHw4fHxPZmZpY2V8ZW58MHx8fHwxNjkzNTYzNzQ1fDA&ixlib=rb-4.0.3&q=80&w=1080","target":"_self","type":"link"}},"children":[],"id":"I9mL3DVNDAKTji5vQM2F7"}],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"sJ_W6Nh8Xt4FguMmSMhQR","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"YrSohHBn4-xI7LMUQezzu","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"3pjGIxBYtledL6ItUdDL8","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}},{"id":"m8F56VGx_TDGDmXAo3-XI","name":"column","children":[],"params":{"borderRadius":{"all":0,"btl":0,"bbl":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}}],"params":{"layout":[1],"gap":100,"minHeight":100,"padding":10,"borderRadius":0}}],"name":"section"}]":0,"btr":0,"bbr":0,"isIndividualCorners":false},"padding":0,"gap":40,"verticalAlignment":"top"}}],"params":{"layout":[1],"gap":100,"minHeight":100,"padding":10,"borderRadius":0}}],"name":"section"}]}
Table of Contents
maxLevel6
minLevel1
include
outlinefalse
indent
exclude
typeflat
printabletrue
class
separatorpipe

This Navigation Data for Applications service allows the retrieval of the full Betfair market navigation menu from a compressed file. 

Info

The file data is cached and new request for the file once an hour should be suitable for those looking to accurately recreate the Betfair navigation menu.

The following request headers are required:

  • X-Application  - Your Application Key

  • X-Authentication Your session token, obtained from the API login response.

Code Block
GET https://api.betfair.com/exchange/betting/rest/v1/en/navigation/menu.json
Connection: keep-alive
X-Application: <AppKey>
X-Authentication: <SessionToken>
Accept: application/json
Accept-Encoding: gzip,deflate

The following languages are supported by the navigation file:

en | en_GB | da | de | es | it | pt | ru | sv

English - en

Spanish - es

Italian  - it

German - de

Swedish - sv

Portuguese  -pt

Russian - ru

Danish - da

ROOT group node has one or many EVENT_TYPE nodes

An EVENT_TYPE node has zero, one or many GROUP nodes

An EVENT_TYPE node has zero, one or many EVENT nodes

A Horse Racing EVENT_TYPE node has zero, one or many RACE nodes

RACE node has one or many MARKET nodes

GROUP node has zero, one or many EVENT nodes

GROUP node has zero, one or many GROUP nodes

An EVENT node has zero, one or many MARKET nodes

An EVENT node has zero, one or many GROUP nodes

An EVENT node has zero, one or many EVENT nodes

{

    "children": [

        {

            EVENT_TYPE1

        },

        {

            EVENT_TYPE2

        },

        ...

    ],

    "id": 0, // always 0

    "name": "ROOT", // always ROOT

    "type": "GROUP" // always GROUP

}

{

    "children": [

        {

            GROUP or EVENT or RACE (RACE only if Greyhounds/Horse Racing)

        },

        ...

    ],

    "id": "1", // Betfair specific eventTypeId

    "name": "Soccer",

    "type": "EVENT_TYPE"

}

{

    "children": [

        {

            GROUP or EVENT

        },

        ...

    ],

    "id": "74568202414", // Not a Betfair specific id, different for every GROUP

    "name": "Womens Soccer",

    "type": "GROUP"

}

{

    "children": [

        {

            GROUP, MARKET or EVENT

        },

        ...

    ],

    "id": "27244118", // Betfair specific eventId

    "name": "South Korea U20 (W) v Mexico U20 (W)",

    "countryCode": "GB",

    "type": "EVENT"

}

{

    "children": [

        {

            MARKET

        },

        ...

    ],

    "id": "27247020.1115", // Betfair specific raceId

    "name": "1300m 3yo",

    "startTime": "2014-08-12T11:15:00.000Z",

    "type": "RACE",

    "venue": "Deauville",

"raceNumber" : "R1", // US specific information about race numbers

    "countryCode": "GB"

}

{  

    "exchangeId": "1", // Betfair specific exchangeId

    "id": "1.114881860", // Betfair specific marketId

    "marketStartTime": "2014-08-14T00:00:00.000Z", // Betfair specific marketStartTime

    "marketType": "WIN", // Betfair specific marketType (e.g. PLACE, WIN, FORECAST etc.)

    "numberOfWinners": "2", // Betfair specific number of winners

    "name": "Over/Under 6.5 Goals",

    "type": "MARKET"

}