A matched board

A matched board: standard, 2up, dutching, each-way, extra-place or bog. The aliases two-up, each_way and extra_place are accepted and served as their canonical slug. Anything else is 404 unknown_type.

ONE lowercase region code (/v2/regions lists yours). Missing means uk: on a data route only when your key covers uk, else 400 region_required naming a code your key has; on discovery and keyless routes always. A comma list, the parameter sent twice or an uppercase code is 400 bad_request; an unknown code, or one with no live bookmaker here, is 404 unknown_region.

envelope (default): {meta, data}. bare: the data array alone, meta moved to X-* headers.

decimal (default) or american (a signed integer; null for a price at or below 1.0). standard and dutching serve decimal only: anything else is 400.

iso (default, ISO-8601 UTC) or unix (integer epoch seconds) for commence_time, processed_at and last_update. standard and dutching serve iso only: anything else is 400.

true (also 1, yes, on): price this exact request instead of serving it. 200 {cost, remaining, rate_card}, free, every check before the price still applies; any other value is an ordinary request.

Comma-separated, at most 20: a sport key or a prefix of one as /v2/sports lists them (horse_racing, soccer), lowercased. A competition key (an event's competition_key, listed on /v2/sports) returns every event of that competition, whatever its venues call it. Any other key returns what it returned before, plus every event a venue files under a key it begins (each venue names its league its own way), and, when every event that key has ever named belongs to ONE competition, the rest of that competition. Unknown is 400 unknown_sport with valid (the sport key bases). A known value with nothing on the board is an empty 200, free. A value is inside your account's scope when it starts with a scope sport (every soccer_… key under soccer); outside, 403 sport_not_in_plan with valid; left out, trimmed to the scope.

Comma-separated, at most 40: bookmaker keys as /v2/bookmakers lists them (a listed name is accepted too). Unknown is 400 unknown_bookmaker with valid; an exchange here is that 400 naming exchanges (on dutching both lists take venues of either kind); a venue outside the region is 403 bookmaker_not_in_region; one outside your plan's bookmaker list or your account's scope is 403 bookmaker_not_in_plan with valid (on dutching, an exchange outside the scope is 403 exchange_not_in_plan). A plan with a bookmaker list, or an account scope, trims a call naming none to that list.

Comma-separated, at most 4: exchange keys as /v2/bookmakers lists them. Unknown is 400 unknown_exchange with valid; a bookmaker here is that 400 naming bookmakers. Outside your account's scope for this product: 403 exchange_not_in_plan with valid; left out, trimmed to the scope.

Comma-separated, at most 20: market keys (h2h, totals, …; /v2/sports rows list the keys seen under each competition). Each product's keys: keyless /v2/coverage's markets. Unknown is 400 unknown_market with valid (this product's keys) and, when another product carries it, products; another product's key may instead be accepted and match nothing. Outside your account's scope for this product: 403 market_not_in_plan with valid; left out, trimmed to the scope.

Events kicking off at or after this ISO-8601 instant (no offset = UTC; a fraction of a second rounds up). Not ISO-8601 is 400; on the matched boards a From after To is 400.

Events kicking off at or before this ISO-8601 instant (no offset = UTC).

Send gzip; with curl, --compressed sends it and decompresses the reply. standard and dutching answer a request that refuses gzip (identity alone, as Python's urllib sends by default, or gzip;q=0 or *;q=0) with 400 bad_request, message add Accept-Encoding: gzip; with curl use --compressed; the other four boards answer it plain.