The API uses environment variables to launch API calls: {{USERNAME}} and {{TOKEN}}. You can set them from TRY IT OUT
Search Referee
GET
/v2.2/search/
Returns referee details and IDs for use in match or league contexts.
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/v2.2/search/?user={{USERNAME}}&token={{TOKEN}}&t=referee&q=John'Response Response Example
{
"data": [
{
"id": 471,
"name": "Beaton, John",
"type": "referee"
},
{
"id": 38,
"name": "Brooks, John",
"type": "referee"
},
{
"id": 865,
"name": "Busby, John",
"type": "referee"
},
{
"id": 1054,
"name": "Crystal, John",
"type": "referee"
},
{
"id": 2910,
"name": "Hines Troza, John",
"type": "referee"
},
{
"id": 1012,
"name": "John, Dean",
"type": "referee"
},
{
"id": 3654,
"name": "Johnson, Jonathan",
"type": "referee"
},
{
"id": 862,
"name": "Johnson, Kevin",
"type": "referee"
},
{
"id": 2754,
"name": "Johnson, Oscar",
"type": "referee"
},
{
"id": 4202,
"name": "Johnson, Paul",
"type": "referee"
},
{
"id": 3629,
"name": "Johnston, Kyle",
"type": "referee"
},
{
"id": 1214,
"name": "Jones, John Andrew",
"type": "referee"
},
{
"id": 1701,
"name": "McKendrick, John",
"type": "referee"
},
{
"id": 1799,
"name": "McLoughlin, John",
"type": "referee"
},
{
"id": 3899,
"name": "Mulligan, John",
"type": "referee"
},
{
"id": 1169,
"name": "Perdomo Horta, John Edison",
"type": "referee"
},
{
"id": 669,
"name": "Pitti, John",
"type": "referee"
},
{
"id": 3762,
"name": "Romagna, John Hinestroza",
"type": "referee"
}
],
"meta": {
"requests_left": 990241,
"user": "soccersapi2",
"plan": "Free Plan",
"pages": 1,
"page": 1,
"count": 0,
"total": 0,
"msg": ""
}
}Modified at 2025-09-28 19:21:09