Get agencies (v1)
GET
https://api.casafari.com/api/v1/references/agenciesBearer token1 parameter
Send Authorization: Bearer $CASAFARI_TOKEN; see how to get a token.
Over MCP: no tool does this. MCP and REST compared.
Description
Returns a list of all possible agencies with user restrictions.
Query parameters
namestringrequiredA name of the agency to search.
Example request
Placeholders only: replace the token and the values with your own.
curl "https://api.casafari.com/api/v1/references/agencies?name=<name>" \
-H "Authorization: Bearer $CASAFARI_TOKEN"Responses
200 OK
Type: object[].
Show the response shape (3 fields)
namestringrequiredName of the agency.
agency_typestringrequiredType of the agency.
source_idsinteger[]requiredList of source IDs that belongs to the agency.
Example from the API description
{
"agencies": [
{
"name": "ComprarCasa Guimarães & Guimarães Centro",
"agency_type": "company",
"source_ids": [
1616,
2492
]
},
{
"name": "ComprarCasa Setúbal Estádio",
"agency_type": "company",
"source_ids": [
1616
]
}
]
}401 Unauthorized
Type: object.
Show the response shape (1 fields)
detailstringDescription of the error encountered.
403 Forbidden
Type: object.
Show the response shape (1 fields)
detailstringDescription of the error encountered.