---
title: "Location Autocomplete"
method: GET
path: "/fincaraiz/location-autocomplete"
tags: ["Fincaraiz"]
---

# Location Autocomplete

`GET /fincaraiz/location-autocomplete`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/fincaraiz/location-autocomplete`
- Auth: API key in header `X-API-KEY`

Resolve Colombian place names into search filter ids.

## Query parameters

- `term` string, required

## Response `200`

- union
  - string
  - object
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'parser_drift', required
      - `message` 'Fincaraiz returned an unreadable response. Please retry.', required
    - `meta` unknown[], required
      - unknown
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` string, required
      - `message` 'Fincaraiz is temporarily unavailable. Please retry.' | 'Fincaraiz could not answer this query. Please retry.' | 'Fincaraiz returned an unreadable response. Please retry.' | 'Fincaraiz rejected the request from our egress pool. Please retry.', required
    - `meta` unknown[], required
      - unknown
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'unknown_filter', required
      - `message` 'term is required.', required
    - `meta` unknown[], required
      - unknown

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: The term is missing or too long. Non-billable.
- `503`: The upstream request failed after retries, or returned a response this endpoint cannot read (`upstream_unavailable`, `parser_drift`). Retryable and never billed. The platform answered successfully with a body this endpoint cannot read, s...

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)