GET /cabaprop/get-branches
Given the Cabaprop token obtained in POST /cabaprop/connect, this service returns the real estate agency profile on Cabaprop and its branches. The profile id (real estate id) and the id of a branch (branch office id) are required to publish listings with POST /cabaprop/publish.
| Resource information | |
|---|---|
| Authentication | Required (Mapaprop token + Cabaprop token) |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
Resource URL
https://property-api.mapaprop.com/cabaprop/get-branches
Headers
| Header | Required | Description |
|---|---|---|
Authorization | yes | Bearer <token> — Mapaprop token |
X-Cabaprop-Token | yes | Cabaprop token obtained in POST /cabaprop/connect |
Response
On success it returns a 200 with the raw agency profile exactly as Cabaprop delivers it:
{
"id": "81592",
"name": "Mi Inmobiliaria",
"email": "contacto@miinmobiliaria.com.ar",
"branchOffices": [
{
"id": "83347",
"branch_office_name": "Casa Central"
}
],
"socialNetworks": {}
}
| Field | Type | Description |
|---|---|---|
id | string | Id of the real estate agency on Cabaprop (real_estate_id, required to publish). |
name | string | Name of the real estate agency. |
email | string | Contact email registered on Cabaprop. |
branchOffices | array | Branches of the real estate agency. Each one has an id (branch_office_id, required to publish) and a branch_office_name. |
socialNetworks | object | Social networks loaded in the Cabaprop profile. |
If branchOffices comes back empty, the real estate agency has no branches loaded on Cabaprop and publishing may fail — at least one branch must be created from the Cabaprop panel.
Errors
| Status | Body | Cause |
|---|---|---|
| 400 | {"error":"X-Cabaprop-Token header is required"} | The X-Cabaprop-Token header is missing. |
| 401 | {"error":"Cabaprop authentication failed"} | The Cabaprop token is invalid or expired. Call POST /cabaprop/connect again. |
| 500 | {"error":"Error fetching Cabaprop branches","detail":"..."} | Unexpected error contacting Cabaprop. |