Skip to main content
GET
/
agencies
Retrieve a list of agencies
curl --request GET \
  --url https://api.recruitifi.com/v1/agencies \
  --header 'Authorization: Bearer <token>'
[
  {
    "optimizedFee": true,
    "id": "<string>",
    "name": "<string>",
    "logoUrl": "<string>",
    "aggregateRating": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Organization-scoped Bearer authentication header of the form Bearer <token>, where <token> is your organization-scoped token from the Organization Scoped Token flow.

Response

200 - application/json

List of agencies

​
optimizedFee
enum<boolean>
required

If an employer wants to automatically use RecruitiFi's optimized fee, they can set optimizedFee to true. If an employer wants to set custom fees, they can set optimizedFee to false and provide a list of custom fees.

Available options:
true,
false
​
id
string
​
name
string
​
logoUrl
string
​
aggregateRating
string

The aggregate of all ratings received by the agency, out of 5. Example: 4.25