Match identifiers
One format, one rule: pass back exactly the identifier the API gave you.
Format
Starter exposes Foresportia public identifiers matching fsm:v1:<64 lowercase hex>.
fsm:v1:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefDo not send source identifiers such as fixture:*. Starter rejects them with
400 invalid_match_id. Preserve the identifier returned by list endpoints and pass it
unchanged to the detail and bulk routes.
Stability
The identifier is reproducibly derived from normalized published match identity inputs. If those inputs change materially — a rescheduled kickoff, a corrected team identity — the public identifier may change. Always treat the identifier in the latest published response as authoritative.
Errors
| Status | Code | When |
|---|---|---|
400 | invalid_match_id | Malformed ID, or a fixture:* identifier. |
404 | match_not_found | Unknown match, or a match outside your selected competitions. |
The 404 is deliberately uniform: it does not reveal whether the match exists but is
unauthorized, which would leak competition access.