Find available deals

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/findDeals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sort_order": "invited",
  "invited_only": "No",
  "school_specific": "No",
  "filterByMinPrice": 100,
  "filterByMaxPrice": 10000,
  "filterCategory": [],
  "filterByLocation": null,
  "filterByPaymentMode": null,
  "filterByJobTitle": [],
  "filterByLatLong": [],
  "filterByDistanceInMiles": 25,
  "allow_private": "Y",
  "job_id": 1,
  "serviceId": 1,
  "type": "All",
  "athlt_university_id": 1,
  "athlete_id": 28550
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/findDeals"

payload = {
    "sort_order": "invited",
    "invited_only": "No",
    "school_specific": "No",
    "filterByMinPrice": 100,
    "filterByMaxPrice": 10000,
    "filterCategory": [],
    "filterByLocation": None,
    "filterByPaymentMode": None,
    "filterByJobTitle": [],
    "filterByLatLong": [],
    "filterByDistanceInMiles": 25,
    "allow_private": "Y",
    "job_id": 1,
    "serviceId": 1,
    "type": "All",
    "athlt_university_id": 1,
    "athlete_id": 28550
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sort_order: 'invited',
    invited_only: 'No',
    school_specific: 'No',
    filterByMinPrice: 100,
    filterByMaxPrice: 10000,
    filterCategory: [],
    filterByLocation: null,
    filterByPaymentMode: null,
    filterByJobTitle: [],
    filterByLatLong: [],
    filterByDistanceInMiles: 25,
    allow_private: 'Y',
    job_id: 1,
    serviceId: 1,
    type: 'All',
    athlt_university_id: 1,
    athlete_id: 28550
  })
};

fetch('http://localhost/mogl/mogl-backend/api/findDeals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/findDeals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sort_order' => 'invited',
    'invited_only' => 'No',
    'school_specific' => 'No',
    'filterByMinPrice' => 100,
    'filterByMaxPrice' => 10000,
    'filterCategory' => [
        
    ],
    'filterByLocation' => null,
    'filterByPaymentMode' => null,
    'filterByJobTitle' => [
        
    ],
    'filterByLatLong' => [
        
    ],
    'filterByDistanceInMiles' => 25,
    'allow_private' => 'Y',
    'job_id' => 1,
    'serviceId' => 1,
    'type' => 'All',
    'athlt_university_id' => 1,
    'athlete_id' => 28550
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/findDeals"

	payload := strings.NewReader("{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/findDeals")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/findDeals")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}"

response = http.request(request)
puts response.read_body

{
  "total_count": 650,
  "data": {
    "current_page": 1,
    "last_page": 65,
    "per_page": 10,
    "total": 650,
    "data": [
      {
        "id": 1204,
        "type": "job",
        "title": "Job on 28th July, 2026",
        "description": "Explain what your company does and why Athletes should work with you.",
        "amount": 100,
        "user_name": "[Dev] Wonolo, Inc.",
        "jobViewPreference": "All MOGL Athletes",
        "is_invited": "N",
        "distance": 12.4,
        "category_arr": [
          {
            "id": "3",
            "name": "Appearances",
            "skill_arr": []
          }
        ],
        "applied_count": 4,
        "linked_count": 30
      }
    ]
  }
}

Find available deals

Returns the deals available to the caller. *

Agent behaviour (ENG-1380): when an agent calls this without athlete_id, the response
covers the whole linked roster instead of one athlete. Every deal card then carries
applied_count and linked_count, and a deal is excluded once every linked athlete has
an application on it. The exclusion is applied before pagination, so total_count and the
page windows already account for it.
linked_count counts every current agent_athletes relationship, approved or not;
outstanding invitations are not links. applied_count counts the distinct linked athletes
with an application on that deal, whether the athlete applied for themselves or the agent
applied for them. Linking a new athlete raises linked_count again and brings a
previously excluded deal back automatically. With an empty roster nothing is excluded so
the agent can still browse.
A private deal follows a narrower rule (ENG-1697), because only the athletes the brand
invited were ever able to apply to it: it stays on the agent’s wall while any invited
represented athlete still has an application to make, and leaves once the last of them has
applied. The whole-roster rule above still governs public deals. Opening a card that has
left Find Deals is unaffected: /searchJob keeps the deal open for an athlete who applied
or was hired.
Passing athlete_id keeps the original single-athlete behaviour, which lets clients
migrate independently. Athlete, partner and fan behaviour is unchanged.

POST

findDeals

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/findDeals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sort_order": "invited",
  "invited_only": "No",
  "school_specific": "No",
  "filterByMinPrice": 100,
  "filterByMaxPrice": 10000,
  "filterCategory": [],
  "filterByLocation": null,
  "filterByPaymentMode": null,
  "filterByJobTitle": [],
  "filterByLatLong": [],
  "filterByDistanceInMiles": 25,
  "allow_private": "Y",
  "job_id": 1,
  "serviceId": 1,
  "type": "All",
  "athlt_university_id": 1,
  "athlete_id": 28550
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/findDeals"

payload = {
    "sort_order": "invited",
    "invited_only": "No",
    "school_specific": "No",
    "filterByMinPrice": 100,
    "filterByMaxPrice": 10000,
    "filterCategory": [],
    "filterByLocation": None,
    "filterByPaymentMode": None,
    "filterByJobTitle": [],
    "filterByLatLong": [],
    "filterByDistanceInMiles": 25,
    "allow_private": "Y",
    "job_id": 1,
    "serviceId": 1,
    "type": "All",
    "athlt_university_id": 1,
    "athlete_id": 28550
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    sort_order: 'invited',
    invited_only: 'No',
    school_specific: 'No',
    filterByMinPrice: 100,
    filterByMaxPrice: 10000,
    filterCategory: [],
    filterByLocation: null,
    filterByPaymentMode: null,
    filterByJobTitle: [],
    filterByLatLong: [],
    filterByDistanceInMiles: 25,
    allow_private: 'Y',
    job_id: 1,
    serviceId: 1,
    type: 'All',
    athlt_university_id: 1,
    athlete_id: 28550
  })
};

fetch('http://localhost/mogl/mogl-backend/api/findDeals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/findDeals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sort_order' => 'invited',
    'invited_only' => 'No',
    'school_specific' => 'No',
    'filterByMinPrice' => 100,
    'filterByMaxPrice' => 10000,
    'filterCategory' => [
        
    ],
    'filterByLocation' => null,
    'filterByPaymentMode' => null,
    'filterByJobTitle' => [
        
    ],
    'filterByLatLong' => [
        
    ],
    'filterByDistanceInMiles' => 25,
    'allow_private' => 'Y',
    'job_id' => 1,
    'serviceId' => 1,
    'type' => 'All',
    'athlt_university_id' => 1,
    'athlete_id' => 28550
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/findDeals"

	payload := strings.NewReader("{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/findDeals")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/findDeals")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sort_order\": \"invited\",\n  \"invited_only\": \"No\",\n  \"school_specific\": \"No\",\n  \"filterByMinPrice\": 100,\n  \"filterByMaxPrice\": 10000,\n  \"filterCategory\": [],\n  \"filterByLocation\": null,\n  \"filterByPaymentMode\": null,\n  \"filterByJobTitle\": [],\n  \"filterByLatLong\": [],\n  \"filterByDistanceInMiles\": 25,\n  \"allow_private\": \"Y\",\n  \"job_id\": 1,\n  \"serviceId\": 1,\n  \"type\": \"All\",\n  \"athlt_university_id\": 1,\n  \"athlete_id\": 28550\n}"

response = http.request(request)
puts response.read_body

{
  "total_count": 650,
  "data": {
    "current_page": 1,
    "last_page": 65,
    "per_page": 10,
    "total": 650,
    "data": [
      {
        "id": 1204,
        "type": "job",
        "title": "Job on 28th July, 2026",
        "description": "Explain what your company does and why Athletes should work with you.",
        "amount": 100,
        "user_name": "[Dev] Wonolo, Inc.",
        "jobViewPreference": "All MOGL Athletes",
        "is_invited": "N",
        "distance": 12.4,
        "category_arr": [
          {
            "id": "3",
            "name": "Appearances",
            "skill_arr": []
          }
        ],
        "applied_count": 4,
        "linked_count": 30
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

JWT Bearer token authentication. Use the /api/login endpoint to obtain a token.

Query Parameters

page

integer

Page number

Example:

1

limit

integer

Items per page

Example:

10

page_limit

integer

Alias for limit

Example:

10

Body

application/json

sort_order

enum<string> | null

Available options:

name_asc,

name_desc,

pay_high,

pay_low,

invited,

recommended,

location_nearest

Example:

"invited"

invited_only

enum<string> | null

Available options:

Yes,

No

Example:

"No"

school_specific

enum<string> | null

Available options:

Yes,

No

Example:

"No"

filterByMinPrice

number | null

Example:

100

filterByMaxPrice

number | null

Example:

10000

filterCategory

integer[] | null

Category IDs

Example:

[]

filterByLocation

string | null

Example:

null

filterByPaymentMode

enum<string> | null

Available options:

Cash,

Product

Example:

null

filterByJobTitle

string[] | null

Exact job title match

Example:

[]

filterByLatLong

number[] | null

[longitude, latitude]

Example:

[]

filterByDistanceInMiles

number | null

Example:

25

allow_private

string | null

Example:

"Y"

job_id

integer | null

Filter to a single job

Example:

1

serviceId

integer | null

Filter to a fan service request

Example:

1

type

string | null

Filter type

Example:

"All"

athlt_university_id

integer | null

Athlete university ID

Example:

1

athlete_id

integer | null

Agent only. Scopes the response to a single represented athlete. Omit to get the roster-wide agent response described above.

Example:

28550

Response

200 - application/json

Available deals

total_count

integer

Example:

650

data

object

Laravel paginator.

Show child attributes

Core API

University API

Notifications API

Find available deals

Authorizations

Query Parameters

Body

Response