API reference
Opono Call-up Forecast
Copy as Markdown
List call-up forecasts
GET /v1/callups
List, at zero credits, the national teams whose next international window has a call-up forecast.
Authentication: Bearer API key with data.read; active Plus or Pro plan required.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Example request
bash
curl 'https://api.opono.com/v1/callups' \
--header "Authorization: Bearer $OPONO_API_KEY"Response
| Field | Type | Description |
|---|---|---|
object | string | list. |
as_of | string or null | When the forecasts were published; null when there are none. |
data | array | National teams in window order. |
data[].team_id | integer | Team ID for the call-up forecast. |
data[].name | string or null | Team name. |
data[].window_starts_at | string | When the window starts, in ISO 8601 UTC. |
data[].preliminary | boolean | True until the squad cutoff. |
data[].candidates | integer | Players ranked for the window. |
Example response
200 response with a test key.
json
{
"object": "list",
"as_of": null,
"data": []
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | parameter_invalid | A parameter has an invalid value. |
| 401 | invalid_api_key | The credential cannot authenticate. |
| 401 | key_revoked | The API key has been revoked. |
| 401 | key_expired | The API key has expired. |
| 403 | scope_missing | The key lacks the required scope. |
| 403 | tier_restricted | The organisation plan does not include this operation. |
| 403 | org_suspended | Your account is suspended. |
| 403 | ip_not_allowed | The caller is outside the key's IP allowlist. |
| 429 | rate_limited | A request or authentication rate limit was exceeded. |
| 503 | dependency_unavailable | Request admission is unavailable. |
| 503 | maintenance | The API is paused for maintenance. |
Opono Call-up Forecast
GET /v1/teams/{team_id}/callups
Read Opono Robin's call-up forecast for a national team's next international window for 1 credit: the players who could be called up, ranked by their chance of being called. It is preliminary until the squad cutoff, 10 days before the window, and the chances tend to run low until then.
Authentication: Bearer API key with data.read; active Plus or Pro plan required.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
team_id | integer | Yes | Request value; minimum: 1. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Maximum rows to return; range: 1–500; default: 60. |
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Example request
bash
curl 'https://api.opono.com/v1/teams/18804/callups?limit=60' \
--header "Authorization: Bearer $OPONO_API_KEY"Response
| Field | Type | Description |
|---|---|---|
object | string | callup_forecast. |
team | object | Team ID and name. |
window.starts_at / window.squad_cutoff | string / string | When the window starts, and about when squads are named. |
window.matches / window.friendlies_only | integer / boolean | Matches in the window, and whether they are all friendlies. |
window.preliminary | boolean | True until the squad cutoff. |
candidates | integer | Players ranked for this window; players holds the first limit. |
players[].player_id / name / position | integer / string or null / string or null | Player labels. |
players[].p_called | number | Opono Robin's chance the player is called up, from 0 to 1. |
players[].rank | integer | Rank by that chance, from 1. |
as_of | string | When the forecast was published, in ISO 8601 UTC. |
publication | string | The publication's day. A new day's forecast is a new paid read; the same one replays for free. |
model.public_name / model.version | string / string | Opono Robin and its release. |
credits_charged | number | One credit on first live delivery; zero for a same-publication replay or test key. |
replay | boolean | Whether your organisation already read this forecast from this publication. |
livemode | boolean | False for synthetic test output. |
receipt | object | Credit receipt on live delivery or replay. |
Example response
200 synthetic test response, shortened to two players; zero credits.
json
{
"object": "callup_forecast",
"team": {
"team_id": 18804,
"name": "Synthetic national team"
},
"window": {
"starts_at": "2026-11-09T00:00:00.000Z",
"squad_cutoff": "2026-10-30T00:00:00.000Z",
"matches": 2,
"friendlies_only": false,
"preliminary": true
},
"candidates": 40,
"players": [
{
"player_id": 1,
"name": "Synthetic player 1",
"position": "goalkeeper",
"p_called": 0.98,
"rank": 1
},
{
"player_id": 2,
"name": "Synthetic player 2",
"position": "defender",
"p_called": 0.955,
"rank": 2
}
],
"as_of": "2026-10-27T10:05:28.000Z",
"publication": "synthetic",
"model": {
"public_name": "Opono Robin",
"version": "synthetic"
},
"credits_charged": 0,
"replay": false,
"livemode": false
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | parameter_invalid | A parameter has an invalid value. |
| 401 | invalid_api_key | The credential cannot authenticate. |
| 401 | key_revoked | The API key has been revoked. |
| 401 | key_expired | The API key has expired. |
| 403 | scope_missing | The key lacks the required scope. |
| 403 | tier_restricted | The organisation plan does not include this operation. |
| 403 | org_suspended | Your account is suspended. |
| 403 | ip_not_allowed | The caller is outside the key's IP allowlist. |
| 429 | rate_limited | A request or authentication rate limit was exceeded. |
| 503 | dependency_unavailable | Request admission is unavailable. |
| 503 | maintenance | The API is paused for maintenance. |
| 402 | balance_too_low | Your available balance cannot cover the request. |
| 404 | window_not_found | No call-up forecast exists for this team. |