KiteProp API

https://www.kiteprop.com/docs/api/v1
Admin
KiteProp API is a REST API for real estate property management that provides endpoints for...
Tokens:50,692
Snippets:212
Trust Score:8.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### Registration Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of successful registration and a bad request error response.

```http
HTTP/2 200 OK
  {
      "success": true,
      "data": {
          "id": 3742,
          "name": "MyAgency",
          "offices": [
              {
                  "id": 4096,
                  "name": "Sucursal principal",
                  "phone": "+5612345678",
                  "email": "info@agency.com",
                  "location_city_id": 7903,
                  "main": 1,
                  "address": null,
                  "map_lat": null,
                  "map_lng": null
              }
          ],
          "users": [
              {
                  "id": 4096,
                  "phone": "+5612345678",
                  "phone_whatsapp": null,
                  "email": "info@agency.com"
              }
          ]
      },
      "errorMessage": null
  }
```

```http
HTTP/2 500 Server error
  {
      "success": false,
      "data": null,
      "errorMessage": "The given data was invalid.",
      "details": {
          "attributes": {
              "referral_code": [
                  "El código de cupon ó referido no es válido"
              ]
          }
      }
  }
```

--------------------------------

### Success Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful 200 OK response containing blog post data and pagination metadata.

```json
HTTP/2 200 OK
{
    "data": [
        {
            "id": 85,
            "title": "Real Estate 2026: el mercado en recuperación",
            "excerpt": "Un resumen de las tendencias del mercado inmobiliario para el año.",
            "body": "<p>El mercado inmobiliario...</p>",
            "slug": "real-estate-2026",
            "active": true,
            "image_url": "https://static.kiteprop.com/kp/blogposts/images/5188/85/lg/abc123.jpg",
            "url": "https://metacordoba.com/site/blog/85/real-estate-2026",
            "categories": [
                { "id": 9, "title": "Novedades", "slug": "novedades" }
            ],
            "user": {
                "id": 7852,
                "full_name": "MetaCordoba Master"
            },
            "organization": {
                "id": 5188,
                "name": "MetaCordoba"
            },
            "created_at": "2026-03-06T21:43:07.000000Z",
            "updated_at": "2026-03-06T21:45:12.000000Z"
        }
    ],
    "links": {
        "first": "https://www.kiteprop.com/api/v1/blogposts?page=1",
        "last": "https://www.kiteprop.com/api/v1/blogposts?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 50,
        "to": 1,
        "total": 1
    }
}
```

--------------------------------

### Success Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example JSON response for a successful request, including property details and pagination metadata.

```json
{
  "data": [
    {
      "property_id": 461363,
      "property_code": "KP461363",
      "property_status": "active",
      "property": {
        "argenprop_id": null,
        "argenprop_last_error": "API response error: ...",
        "argenprop_last_update": "2026-01-15 03:41:32",
        "mercadolibre_id": "MLA1608064167",
        "mercadolibre_url": "https://articulo.mercadolibre.com.ar/MLA-1608064167-Kiteprop-_JM",
        "properstar_id": "https://dashboard.properstar.com/s/?accountId=6304561&listingId=461363",
        "properstar_last_update": "2026-01-15 09:45:17",
        "zonaprop_id": null,
        "site_visits": 76,
        "old_ids": { "mercadolibre": [] }
      },
      "clones": []
    }
  ],
  "links": {
    "first": "https://local.kiteprop.com/api/v1/difusions/report?page=1",
    "last": "https://local.kiteprop.com/api/v1/difusions/report?page=10",
    "prev": "https://local.kiteprop.com/api/v1/difusions/report?page=2",
    "next": "https://local.kiteprop.com/api/v1/difusions/report?page=4"
  },
  "meta": {
    "current_page": 3,
    "from": 31,
    "last_page": 10,
    "per_page": 15,
    "to": 45,
    "total": 139,
    "sending": {
      "mercadolibre": 86,
      "argenprop": 84,
      "properstar": 84,
      "yumblin": 84
    }
  }
}
```

--------------------------------

### Property Description Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of successful and error responses for the description generation endpoint.

```json
HTTP/1.1 200 OK
{
  "success": true,
  "data": {
    "description": "Beautiful 2-bedroom apartment...",
    "templateType": "property_description",
    "tokensUsed": 412
  },
  "errorMessage": null
}
```

```json
HTTP/1.1 402 Payment Required
{
  "success": false,
  "data": null,
  "errorMessage": "Sin cupo de tokens OpenAI."
}
```

```json
HTTP/1.1 403 Forbidden
{
  "success": false,
  "data": null,
  "errorMessage": "This action is unauthorized."
}
```

--------------------------------

### Development Units Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Example responses for successful retrieval, not found errors, and forbidden access.

```json
HTTP/2 200 OK
{
    "data": [
        {
            "id": 75100,
            "code": "KP75100",
            "internal_id": null,
            "source_id": null,
            "type": "apartments",
            "status": "active",
            "title": "Unit 4B — 2 bedrooms",
            "description": "Spacious 2-bedroom unit on floor 4, south-facing.",
            "images_list": [],
            "city": "Buenos Aires",
            "neighborhood": "Palermo",
            "address": "Av. Libertador 1200",
            "for_sale": true,
            "for_sale_price": 185000,
            "currency": "usd",
            "created_at": "2025-03-01T00:00:00.000000Z",
            "updated_at": "2025-05-10T00:00:00.000000Z"
        }
    ],
    "links": {
        "first": "https://www.kiteprop.com/api/v1/developments/42/units?page=1",
        "last": "https://www.kiteprop.com/api/v1/developments/42/units?page=2",
        "prev": null,
        "next": "https://www.kiteprop.com/api/v1/developments/42/units?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "per_page": 15,
        "to": 15,
        "total": 24
    }
}
```

```json
HTTP/2 404 Not Found
{
    "success": false,
    "data": null,
    "errorMessage": "No query results for model [App\\Models\\Development].",
    "details": []
}
```

```json
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "This action is unauthorized.",
    "details": []
}
```

--------------------------------

### API Key Authentication Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of a successful profile request using an API key and a failed unauthorized response.

```http
curl -H "X-API-Key: kp_xxxxx..." https://app.kiteprop.com/api/v1/profile

HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 123,
        "email": "user@agency.com",
        "full_name": "John Doe",
        "office_id": 456,
        "role_id": 2
    },
    "errorMessage": null
}
```

```http
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "Invalid API key",
    "details": []
}
```

--------------------------------

### Contact Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of successful and error responses for contact retrieval.

```json
HTTP/1.1 200 OK
{
    "success": true,
    "data": {
        "id": 1036608,
        "first_name": "Florencia",
        "last_name": "Serra",
        "full_name": "Florencia Serra",
        "email": "florencia.serra@example.com",
        "email_alternative": "flor.serra.alt@example.com",
        "phone": "+54 9 341 2275819",
        "phone_alternatives": ["+54 9 341 1111111", "+54 9 341 2222222"],
        "category_id": 9,
        "acquisition_category_id": null,
        "is_lead": true,
        "is_owner": false,
        "probs": 2,
        "source": "argenprop",
        "charge": "Agente Inmobiliaria",
        "company": "Inmobiliaria del Sur",
        "facebook": "https://facebook.com/flor.serra.example",
        "instagram": "@flor.serra.example",
        "website": "https://www.inmobiliariadelsur.com",
        "twitter": "@florSerraProp",
        "summary": "Cliente interesada en propiedades de 3 ambientes en zona oeste.",
        "address": "Calle Falsa 123",
        "dni": "30111222",
        "cuit": "20301112223",
        "gender": "female",
        "last_activity": "2025-07-04T18:40:46.000000Z",
        "tags": ["arriendos", "newsletter", "vip"],
        "category": {
            "id": 9,
            "name": "Siguiendo"
        },
        "acquisition_category": null,
        "created_at": "2025-01-29T21:38:51.000000Z",
        "updated_at": "2025-07-04T18:40:46.000000Z",
        "user": {
            "id": 33,
            "email": "asesor@kiteprop.com",
            "phone": "+54 9 341 3888888",
            "phone_whatsapp": "+54 9 341 3666666",
            "full_name": "Claudia Ramírez"
        },
        "assigned_user": {
            "id": 45,
            "email": "carla@kiteprop.com",
            "phone": "+54 9 341 3777777",
            "phone_whatsapp": "+54 9 341 3555555",
            "full_name": "Carla Juárez"
        }
    },
    "errorMessage": null
}
```

```json
HTTP/1.1 404 Not Found
{
    "success": false,
    "data": null,
    "errorMessage": "El contacto no fue encontrado.",
    "details": []
}
```

```json
HTTP/2 500 Server Error
{
    "success": false,
    "data": null,
    "errorMessage": "No se pudo obtener el contacto.",
    "details": []
}
```

--------------------------------

### Deprecated Login Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of successful login and a bad request error response.

```http
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "access_token": "thisisjwttokenshouldbelonger",
        "expires_at": "2022-10-20T15:44:40.000000Z"
    },
    "errorMessage": null
}
```

```http
HTTP/2 500 Server error
{
    "success": false,
    "data": null,
    "errorMessage": "Invalid credentials",
    "details": []
}
```

--------------------------------

### Success Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful 200 OK response containing a list of messages and pagination metadata.

```json
HTTP/2 200 OK
    {
      "data": [
        {
          "id": 509375,
          "created_at": "2024-02-07T21:57:29.000000Z",
          "body": "Hola, Soy Juan. Estoy interesado en su anuncio. Me pueden contactar?",
          "source": "olx",
          "property_id": 186421,
          "contact": {
            "id": 561678,
            "full_name": "Juan Perez",
            "email": "juan@gmail.com",
            "phone": "+5491112345678",
            "created_at": "2024-02-07T21:57:29.000000Z",
            "updated_at": "2024-03-07T11:35:46.000000Z"
          }
        },
        {
          "id": 481623,
          "created_at": "2024-12-30T22:01:12.000000Z",
          "body": "Hola, Soy Julian. Estoy interesado en su anuncio. Me pueden contactar?",
          "source": "mercadolibre",
          "property_id": 156548,
          "contact": {
            "id": 516526,
            "full_name": "Julian Gomez",
            "email": "julian@gmail.com",
            "phone": "+5491112345678",
            "created_at": "2024-12-30T22:01:12.000000Z",
            "updated_at": "2024-03-07T11:32:18.000000Z"
          }
        }
      ],
      "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 75,
        "per_page": 15,
        "to": 15,
        "total": 1117
      }
    }
```

--------------------------------

### Error Response Example

Source: https://www.kiteprop.com/docs/api/v1

An example of an error response returned by the server.

```json
HTTP/2 500 Server Error
{
    "success": false,
    "data": null,
    "errorMessage": "No se pudo obtener la lista de contactos.",
    "details": []
}
```

--------------------------------

### Contact context response examples

Source: https://www.kiteprop.com/docs/api/v1

Example responses for successful lookups, missing contacts, validation errors, and authorization failures.

```json
HTTP/1.1 200 OK
{
    "success": true,
    "data": {
        "exists": true,
        "contact": {
            "id": 1036608,
            "first_name": "Florencia",
            "last_name": "Serra",
            "full_name": "Florencia Serra",
            "email": "florencia.serra@example.com",
            "phone": "+54 9 341 2275819",
            "is_lead": true,
            "is_owner": false,
            "source": "argenprop",
            "category": { "id": 9, "name": "Siguiendo" },
            "created_at": "2025-01-29T21:38:51.000000Z"
        },
        "messages": [
            {
                "id": 998877,
                "body": "Hola, me interesa la propiedad. ¿Sigue disponible?",
                "source": "argenprop",
                "action_type": "message",
                "property_id": 55221,
                "replied": true,
                "created_at": "2025-07-01T13:20:11.000000Z"
            }
        ],
        "properties": [
            {
                "id": 55221,
                "code": "KP1023",
                "title": "Departamento 2 ambientes en Centro",
                "type": "apartment",
                "optype": ["sale", "rental"],
                "status": "active",
                "relation_type": "interested"
            }
        ],
        "searches": [
            {
                "id": 4412,
                "title": "Departamento en Alquiler",
                "description": "1 ó mas dormitorios entre USD $ 300 hasta USD $ 600 en Rosario",
                "location": "Rosario, Santa Fe",
                "type": "apartment",
                "optype": "rental",
                "min_price": 300,
                "max_price": 600,
                "currency": "USD",
                "active": true,
                "expiration_date": "2026-09-01",
                "created_at": "2025-06-10T10:00:00.000000Z"
            }
        ]
    },
    "errorMessage": null
}
```

```json
HTTP/1.1 200 OK
{
    "success": true,
    "data": { "exists": false },
    "errorMessage": null
}
```

```json
HTTP/1.1 422 Unprocessable Entity
{
    "success": false,
    "data": null,
    "errorMessage": "El parámetro phone es obligatorio.",
    "details": []
}
```

```json
HTTP/1.1 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "This action is unauthorized.",
    "details": []
}
```

--------------------------------

### Error Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example JSON response for a server-side error.

```json
HTTP/2 500 Server error
{
  "success": false,
  "data": null,
  "errorMessage": "Internal server error",
  "details": []
}
```

--------------------------------

### Success 200 Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful HTTP 200 response containing property data.

```json
HTTP/2 200 OK
{
     "data": [
         {
             "id": 75052,
             "code": "KP75052",
             "internal_id": "ME4349_28",
             "source_id": "TV-493391-22",
             "development_id": null,
             "type": "houses",
             "status": "active",
             "title": "Roldán tierras de sueños 2",
             "description": "Casa a estrenar, en planta baja living comedor, cocina separada, jardín de invierno, cochera semicubierta.",
             "images_list": [
                 {
```

--------------------------------

### Appraisal API Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Examples of HTTP responses for successful appraisal creation, validation errors, and forbidden access.

```json
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 512340,
        "code": "KPT512340",
        "status": "appraisal",
        "title": "Tasación — Av. San Martín 8455",
        "appraisal": {
            "value": 145000,
            "currency_id": 1,
            "currency": "usd",
            "requested_at": null,
            "captured_at": null,
            "notes": "El propietario pide 160k.",
            "source_message_id": null,
            "appraiser": {
                "id": 3147,
                "full_name": "Juan Perez",
                "email": "juan@email.com"
            }
        }
    },
    "errorMessage": null
}
```

```json
HTTP/2 500 Server error
{
    "success": false,
    "data": null,
    "errorMessage": "The given data was invalid.",
    "details": {
        "attributes": {
            "title": ["El campo es obligatorio"],
            "optype.sale": ["Marcá al menos un tipo de operación (Venta, Alquiler o Alquiler temporario)."]
        }
    }
}
```

```json
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "No estás autorizado a realizar esta acción.",
    "details": []
}
```

--------------------------------

### Successful Development Creation Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a 200 OK response returned after successfully creating a development.

```json
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 43,
        "code": "KPD43",
        "title": "Central Park Lots",
        "development_name": null,
        "internal_id": null,
        "type": "lot_developments",
        "status": "active",
        "description": "Premium lots with all utilities available.",
        "private_description": null,
        "progress": "pre_construction",
        "delivery_date": "2027-12-01",
        "address": "Route 9 km 48",
        "map_lat": -34.12,
        "map_lng": -58.99,
        "city": "Pilar",
        "neighborhood": null,
        "currency": "USD",
        "currency_id": 1,
        "floors": null,
        "elevators": null,
        "parking_spaces": null,
        "min_unit_meters": 300,
        "max_unit_meters": 1200,
        "yard_meters": null,
        "common_meters": null,
        "estimated_expenses": null,
        "financing_info": "Installments adjusted by CCI index",
        "amenities": ["24hs Security", "Paved access road", "Artificial lagoon"],
        "typologies": ["Standard lot", "Premium lot", "Lagoon-view lot"],
        "link_youtube": null,
        "link_360_iframe": null,
        "website_url": null,
        "website_disabled": false,
        "images_list": [],
        "user": {
            "id": 301,
            "email": "juan@realestate.com",
            "phone": "+5491160001234",
            "full_name": "Juan Perez"
        },
        "organization": {
            "id": 100,
            "name": "Demo Real Estate",
            "phone": "+5491160000000",
            "email": "info@demorealestate.com"
        },
        "created_at": "2025-05-22T10:00:00.000000Z",
        "updated_at": "2025-05-22T10:00:00.000000Z"
    },
    "errorMessage": null
}
```

--------------------------------

### Handle Success Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a 200 OK response containing the appraisal data object.

```http
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 512340,
        "code": "KPT512340",
        "status": "appraisal",
        "type": "apartments",
        "title": "Tasación — Av. San Martín 8455",
        "address": "Av. San Martín 8455",
        "geo": { "lat": -32.9307106, "lon": -60.8914057 },
        "total_meters": 80,
        "currency": "usd",
        "for_sale": true,
        "price_usd": null,
        "appraisal": {
            "value": 145000,
            "currency_id": 1,
            "currency": "usd",
            "requested_at": "2026-08-02T14:10:00.000000Z",
            "captured_at": null,
            "notes": "El propietario pide 160k.",
            "source_message_id": null,
            "appraiser": {
                "id": 3147,
                "full_name": "Juan Perez",
                "email": "juan@email.com"
            }
        },
        "owner_contact": null
    },
    "errorMessage": null
}
```

--------------------------------

### Success Response Example

Source: https://www.kiteprop.com/docs/api/v1

A successful response returns a paginated list of contact objects with metadata.

```json
HTTP/1.1 200 OK
{
    "data": [
        {
            "id": 1036608,
            "first_name": "Florencia",
            "last_name": "Serra",
            "full_name": "Florencia Serra",
            "email": "florencia.serra@example.com",
            "email_alternative": "flor.serra.alt@example.com",
            "phone": "+54 9 341 2275819",
            "phone_alternatives": ["+54 9 341 1111111", "+54 9 341 2222222"],
            "category_id": 9,
            "acquisition_category_id": null,
            "is_lead": true,
            "is_owner": false,
            "probs": 2,
            "source": "mercadolibre",
            "charge": "Agente Inmobiliaria",
            "company": "Inmobiliaria del Sur",
            "facebook": "https://facebook.com/flor.serra.example",
            "instagram": "@flor.serra.example",
            "website": "https://www.inmobiliariadelsur.com",
            "twitter": "@florSerraProp",
            "summary": "Cliente interesada en propiedades de 3 ambientes en zona oeste.",
            "address": "Calle Falsa 123",
            "dni": "30111222",
            "cuit": "20301112223",
            "gender": "female",
            "last_activity": "2025-07-04T18:40:46.000000Z",
            "tags": ["arriendos", "newsletter", "vip"],
            "category": {
                "id": 9,
                "name": "Siguiendo"
            },
            "acquisition_category": null,
            "created_at": "2025-01-29T21:38:51.000000Z",
            "updated_at": "2025-07-04T18:40:46.000000Z",
            "user": {
                "id": 33,
                "email": "asesor@kiteprop.com",
                "phone": "+54 9 341 3888888",
                "phone_whatsapp": "+54 9 341 3666666",
                "full_name": "Claudia Ramírez"
            },
            "assigned_user": {
                "id": 45,
                "email": "carla@kiteprop.com",
                "phone": "+54 9 341 3777777",
                "phone_whatsapp": "+54 9 341 3555555",
                "full_name": "Carla Juárez"
            }
        }
    ],
    "links": {
        "first": "https://www.kiteprop.com/api/v1/contacts?page=1",
        "last": "https://www.kiteprop.com/api/v1/contacts?page=10",
        "prev": null,
        "next": "https://www.kiteprop.com/api/v1/contacts?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 10,
        "path": "https://www.kiteprop.com/api/v1/contacts",
        "per_page": 15,
        "to": 15,
        "total": 150,
        "links": [
            {
                "url": null,
                "label": "&laquo; Anterior",
                "active": false
            },
            {
                "url": "https://www.kiteprop.com/api/v1/contacts?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https://www.kiteprop.com/api/v1/contacts?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": null,
                "label": "Siguiente &raquo;",
                "active": false
            }
        ]
    }
}
```

--------------------------------

### HTTP 200 Success Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful API response containing property data, including images and identifiers.

```json
HTTP/2 200 OK
{
     "success": true,
     "data": {
         "id": 75052,
         "code": "KP75052",
         "internal_id": "ME4349_28",
         "source_id": "TV-493391-22",
         "type": "houses",
         "status": "active",
         "title": "Roldán tierras de sueños 2",
         "description": "Casa a estrenar, en planta baja living comedor, cocina separada, jardín de invierno, cochera semicubierta.",
         "images_list": [
             {
                 "id": 4385527,
                 "title": "Frente de la casa",
                 "main": true,
                 "blueprint": false,
                 "internal": false,
                 "position": 0,
                 "updated_at": "2025-11-14T18:11:22.000000Z",
                 "created_at": "2025-11-14T18:02:45.000000Z",
                 "sm": "https://static.kiteprop.com/kp/properties/75052/695182/sm/6951823c44f3746db1ca6db7569fa7a2.jpg",
                 "md": "https://static.kiteprop.com/kp/properties/75052/695182/md/6951823c44f3746db1ca6db7569fa7a2.jpg",
                 "lg": "https://static.kiteprop.com/kp/properties/75052/695182/lg/6951823c44f3746db1ca6db7569fa7a2.jpg"
             },
             {
                 "id": 4385501,
                 "title": null,
                 "main": false,
                 "blueprint": false,
                 "internal": false,
                 "position": 1,
                 "updated_at": "2025-11-14T18:11:22.000000Z",
                 "created_at": "2025-11-14T18:01:53.000000Z",
                 "sm": "https://static.kiteprop.com/kp/properties/75052/96b7c0/sm/96b7c0c74acec34bd4ee8575914bc0a7.jpg",
                 "md": "https://static.kiteprop.com/kp/properties/75052/96b7c0/md/96b7c0c74acec34bd4ee8575914bc0a7.jpg",
                 "lg": "https://static.kiteprop.com/kp/properties/75052/96b7c0/lg/96b7c0c74acec34bd4ee8575914bc0a7.jpg"
             },
         ],
         "link_youtube": "https://www.youtube.com/watch?v=UMqVEV6cOaw",
```

--------------------------------

### GET /api/v1/properties/activities

Source: https://www.kiteprop.com/docs/api/v1

Lists all property activities. Returns paginated results.

```APIDOC
## GET https://www.kiteprop.com/api/v1/properties/activities

### Description
Lists all property activities. Returns paginated results.

### Method
GET

### Endpoint
https://www.kiteprop.com/api/v1/properties/activities
```

--------------------------------

### Error Validation Response Example

Source: https://www.kiteprop.com/docs/api/v1

Example of a 500 Server error response returned when validation fails.

```json
HTTP/2 500 Server error
    {
        "success": false,
        "data": null,
        "errorMessage": "The given data was invalid.",
        "details": {
            "attributes": {
                "email": [
                    "El campo es obligatorio"
                ]
            }
        }
    }
```

--------------------------------

### User Profile Success Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful 200 OK response for the profile endpoint.

```json
HTTP/2 200 OK
    {
        "success": true,
        "data": {
            "id": 3,
            "email": "usuario@kiteprop.com",
            "first_name": "Juan",
            "last_name": "Dominguez",
            "phone": "5491131444000",
            "phone_whatsapp": "+5491131444578",
            "role_id": 2,
            "office_id": 2,
            "organization_id": 25,
            "full_name": "Juan Dominguez",
            "avatar": "https://static.kiteprop.com/kp/crm/images/users/lg/3-511b04cbcf06cafd47acd6f81e3bdfc2.jpg"
        },
        "errorMessage": null
    }
```

--------------------------------

### Appraisal Update Responses

Source: https://www.kiteprop.com/docs/api/v1

Example responses for successful updates, missing resources, and authorization errors.

```http
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 512340,
        "code": "KPT512340",
        "status": "appraisal",
        "appraisal": {
            "value": 152000,
            "currency_id": 1,
            "currency": "usd",
            "notes": "Segunda visita: mejor estado del esperado."
        }
    },
    "errorMessage": null
}
```

```http
HTTP/2 404 Not Found
{
    "success": false,
    "data": null,
    "errorMessage": "Tasación no encontrada",
    "details": []
}
```

```http
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "No estás autorizado a realizar esta acción.",
    "details": []
}
```

--------------------------------

### Pagination Response Structure

Source: https://www.kiteprop.com/docs/api/v1

Example of the pagination metadata returned in a properties list response.

```json
         "first_page_url": "https://www.kiteprop.com/api/v1/properties?page=1",
         "last_page_url": "https://www.kiteprop.com/api/v1/properties?page=92",
         "next_page_url": "https://www.kiteprop.com/api/v1/properties?page=3",
         "prev_page_url": "https://www.kiteprop.com/api/v1/properties?page=1",
         "links": []
     }
 }
```

--------------------------------

### List Users Success Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful 200 OK response for the user list endpoint.

```json
HTTP/1.1 200 OK
{
    "data": [
        {
            "id": 3,
            "email": "usuario@kiteprop.com",
            "first_name": "Juan",
            "last_name": "Dominguez",
            "phone": "5491131444000",
            "phone_whatsapp": "+5491131444578",
            "role_id": 2,
            "office_id": 2,
            "organization_id": 25,
            "full_name": "Juan Dominguez",
            "avatar": "https://static.kiteprop.com/kp/crm/images/users/lg/3-511b04cbcf06cafd47acd6f81e3bdfc2.jpg"
        }
    ],
    "links": {
        "first": "https://www.kiteprop.com/api/v1/users?page=1",
        "last": "https://www.kiteprop.com/api/v1/users?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Anterior",
                "active": false
            },
            {
                "url": "https://www.kiteprop.com/api/v1/users?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Siguiente &raquo;",
                "active": false
            }
        ],
        "path": "https://www.kiteprop.com/api/v1/users",
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}
```

--------------------------------

### GET https://www.kiteprop.com/api/v1/developments

Source: https://www.kiteprop.com/docs/api/v1

Returns a paginated list of developments. Results are cached for 2 minutes.

```APIDOC
## GET https://www.kiteprop.com/api/v1/developments

### Description
Returns a paginated list of developments. Results are cached for 2 minutes.

### Method
GET

### Endpoint
https://www.kiteprop.com/api/v1/developments

### Parameters
#### Query Parameters
- **q** (String) - Optional - Search by title (prefix match)
- **type** (String) - Optional - Development type (buildings, office_buildings, lot_developments, industrial_parks)
- **status** (String) - Optional - Development status ('active', 'inactive')
- **progress** (String) - Optional - Filter by construction progress (pre_construction, under_construction, completed, delivered)
- **order** (String) - Optional - Sort order (default: id:desc)
- **limit** (Number) - Optional - Results per page (default: 15)
- **page** (Number) - Optional - Page number
```

--------------------------------

### Error Response Examples

Source: https://www.kiteprop.com/docs/api/v1

Standard error responses for missing resources or unauthorized access attempts.

```http
HTTP/2 404 Not Found
{
    "success": false,
    "data": null,
    "errorMessage": "No query results for model [App\\Models\\Development].",
    "details": []
}
```

```http
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "This action is unauthorized.",
    "details": []
}
```

--------------------------------

### Handle Error Responses

Source: https://www.kiteprop.com/docs/api/v1

Examples of 404 Not Found and 403 Forbidden error responses.

```http
HTTP/2 404 Not Found
{
    "success": false,
    "data": null,
    "errorMessage": "Tasación no encontrada",
    "details": []
}
```

```http
HTTP/2 403 Forbidden
{
    "success": false,
    "data": null,
    "errorMessage": "No estás autorizado a realizar esta acción.",
    "details": []
}
```

--------------------------------

### Search Locations via cURL

Source: https://www.kiteprop.com/docs/api/v1

Example of how to query the locations endpoint using cURL with an API key.

```bash
curl -H "X-API-Key: kp_eDdpxSj6j....." "https://www.kiteprop.com/api/v1/locations/specimen/search?q=recoleta"
```

--------------------------------

### Successful Contact Update Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a 200 OK response returning the updated contact object.

```http
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 1123666,
        "first_name": "Laura",
        "last_name": "Martínez",
        "full_name": "Laura Martínez",
        "email": "laura@email.com",
        "email_alternative": null,
        "phone": "+5491199999999",
        "phone_alternatives": null,
        "category_id": 714,
        "probs": null,
        "source": null,
        "charge": "Gerenta de ventas",
        "company": "Inmuebles XYZ",
        "facebook": null,
        "instagram": null,
        "website": null,
        "twitter": null,
        "summary": null,
        "address": null,
        "dni": null,
        "cuit": null,
        "gender": null,
        "last_activity": "2025-07-04T18:25:41.000000Z",
        "tags": ["vip", "recurrente"],
        "category": {
            "id": 714,
            "name": "Nuevo"
        },
        "created_at": "2025-07-04T18:09:41.000000Z",
        "updated_at": "2025-07-04T18:25:41.000000Z",
        "user": {
            "id": 12345,
            "email": "developers@kiteprop.com",
            "phone": "+549111234567",
            "phone_whatsapp": "+549111234567",
            "full_name": "Juan Perez"
        },
        "assigned_user": {
            "id": 345,
            "email": "asesor@inmobiliaria.com",
            "phone": "+5491122223333",
            "phone_whatsapp": "+5491122223333",
            "full_name": "Carla Romero"
        }
    },
    "errorMessage": null
}
```

--------------------------------

### Development Success Response

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful HTTP 200 response containing the full development data object.

```json
HTTP/2 200 OK
{
    "success": true,
    "data": {
        "id": 42,
        "code": "KPD42",
        "title": "Torres del Parque — Special Edition",
        "development_name": "Torres del Parque",
        "internal_id": "TP-001",
        "type": "buildings",
        "status": "active",
        "description": "Updated description with new amenities.",
        "private_description": null,
        "progress": "completed",
        "delivery_date": "2025-12-01",
        "address": "Av. Libertador 1200",
        "map_lat": -34.563,
        "map_lng": -58.461,
        "city": "Buenos Aires",
        "neighborhood": "Palermo",
        "currency": "USD",
        "currency_id": 1,
        "floors": 12,
        "elevators": 3,
        "parking_spaces": 90,
        "min_unit_meters": 45,
        "max_unit_meters": 140,
        "yard_meters": null,
        "common_meters": 350,
        "estimated_expenses": 5500,
        "financing_info": "Immediate delivery, bank financing available",
        "amenities": ["Pool", "Gym", "Event Room", "Rooftop", "Bike storage"],
        "typologies": ["1 bedroom", "2 bedrooms", "3 bedrooms", "Penthouse"],
        "link_youtube": "https://www.youtube.com/watch?v=XrkeQqdOFgw",
        "link_360_iframe": "https://my.matterport.com/show/?m=Ez3YDocMaVx",
        "website_url": "https://torresdelparque.com",
        "website_disabled": false,
        "images_list": [],
        "user": {
            "id": 301,
            "email": "juan@realestate.com",
            "phone": "+5491160001234",
            "full_name": "Juan Perez"
        },
        "organization": {
            "id": 100,
            "name": "Demo Real Estate",
            "phone": "+5491160000000",
            "email": "info@demorealestate.com"
        },
        "created_at": "2025-01-01T00:00:00.000000Z",
        "updated_at": "2025-05-22T15:00:00.000000Z"
    },
    "errorMessage": null
}
```

--------------------------------

### Success response for contact categories

Source: https://www.kiteprop.com/docs/api/v1

Example of a successful 200 OK response containing the list of categories.

```json
HTTP/1.1 200 OK
{
    "data": [
        {
            "id": 7,
            "name": "Recien llegados",
            "description": "Necesita ser contactado",
            "maximum_stay": 3,
            "default": true
        },
        {
            "id": 8,
            "name": "Contactado",
            "description": "Contactado pero aún sin calificar",
            "maximum_stay": 8,
            "default": false
        },
        {
            "id": 9,
            "name": "Siguiendo",
            "description": "En pleno proceso de actividad",
            "maximum_stay": 10,
            "default": false
        },
        {
            "id": 10,
            "name": "Visitas",
            "description": "Contactos en proceso de visitas (pactadas)",
            "maximum_stay": 10,
            "default": false
        },
        {
            "id": 11,
            "name": "Futuro",
            "description": "Contactos que deben verse mas adelante",
            "maximum_stay": 90,
            "default": false
        },
        {
            "id": 12,
            "name": "Descartado",
            "description": "No es un cliente potencial calificado",
            "maximum_stay": null,
            "default": false
        }
    ]
}
```

--------------------------------

### List Properties Request

Source: https://www.kiteprop.com/docs/api/v1

Use this GET request to retrieve a paginated list of properties from the KiteProp API.

```http
GET https://www.kiteprop.com/api/v1/properties
```
Tokens:
Raw