📘

El endpoint lo encuentras en el apartado Agencies en la referencia de nuestra API.

Tenemos disponibles dos endpoints sobre las agencias conectadas a tu aplicación.

Obtener todas las agencias

Con este endpoint podrás obtener todas las agencias activas que estén conectadas a tu aplicación en el momento del request.

Además de los parametros predeterminados de página y límite del número de resultados, tienes la opción de agregar un filtro de fecha, con lo que podrás acotar tu búsqueda cuando realices consultas para ver nuevas actualizaciones.

En el siguiente ejemplo hacemos un request para obtener todas las agencias:

curl --request GET \
     --url 'https://api.easybroker.com/v1/integration_partners/agencies?page=1&limit=100' \
     --header 'Country-Code: MX' \
     --header 'X-Authorization: $API_KEY' \
     --header 'accept: application/json'

Y el resultado es el siguiente:

{
  "pagination": {
    "limit": 100,
    "page": 1,
    "total": 98,
    "next_page": null
  },
  "content": [
    {
      "id": 3401,
      "name": "NERV",
      "account_owner": "Ricardo Sanchez",
      "logo_url": null,
      "phone": "+525515634149",
      "email": "[email protected]"
    },
    ...
    {
      "id": 3391,
      "name": "Inmobiliaria Rosa",
      "account_owner": "Rosa Martinez",
      "logo_url": null,
      "phone": "+525591801527",
      "email": "[email protected]"
    },
    {
      "id": 4179,
      "name": "Inmobiliaria Trueno",
      "account_owner": "Mateo Palacios",
      "logo_url": null,
      "phone": null,
      "email": "[email protected]"
    }
  ]
}

Obtener los datos de una agencia en específico

Si quieres saber los datos de una agencia necesitarás el agency_id y deberás hace una consulta al endpoint /get_agencies-agency-id.

Un ejemplo del request que deberás hacer es este:

curl --request GET \
     --url https://api.stagingeb.com/v1/integration_partners/agencies/agency_id \
     --header 'Country-Code: MX' \
     --header 'X-Authorization: $API_KEY' \
     --header 'accept: application/json'

Y la respuesta será así:

{
  "id": 1204,
  "name": "NERV",
  "account_owner": "Eduardo Sanchez",
  "logo_url": "https://assets.easybroker.com/organization_logos/1204/pexels-pixabay-209315__scaled_.jpg?version=1712851202",
  "phone": "+525511145262",
  "email": "[email protected]"
}

Recomendaciones

• Una vez que guardes esta información, recuerda relacionarla usando el ID de la agencia.
• Los datos de la agencia pueden llegar a cambiar, te recomendamos hacer actualizaciones al menos una vez a la semana.