---
title: "Parcel at a point (WGS84), JSON body"
method: POST
path: "/api/search/coordinates"
tags: ["Parcels"]
---

# Parcel at a point (WGS84), JSON body

`POST /api/search/coordinates`

## Request

- Base URL: `https://api.parcelgps.com`
- URL: `https://api.parcelgps.com/api/search/coordinates`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `latitude` number, required
  - `longitude` number, required
  - `country` string: ISO code of the country: ES, PV, NA, FR, IT, DE, AT, PT, PL, NL, CH, BE, CZ, DK, FI, EE, SI, LT, LU, SK, BG, LI, IS, CY, GR, LV, IE, HR, UK, SE. Detected from the point when omitted.

## Response `200`

The parcel at that point.

- CoordinatesResponse
  - `success` true, required
  - `data` object, required
    - `referenciaCatastral` string
    - `refCat14` string
    - `direccion` string
    - `codigoPostal` string
    - `municipio` string
    - `tipoInmueble` string
    - `coordenadas` object
      - `latitud` number
      - `longitud` number
    - `googleMapsUrl` string
    - `pais` string
  - `searchesRemaining` integer

## Other responses

- `400`: Malformed parameters (code VALIDATION_ERROR).
- `401`: Missing, malformed or unknown API key (KEY_AUTH_001, KEY_AUTH_002, KEY_AUTH_003, UNAUTHORIZED).
- `404`: The reference or address does not exist (code NOT_FOUND). Never used for outages.
- `429`: KEY_AUTH_004: monthly quota used up and no prepaid balance left to cover the request (see X-Quota-*); nothing is charged. The message says the plan, the price per 1,000 extra units, where to top up and when the quota resets. KEY_RATE_002 or RATE_LIMIT_EXCEEDED: per-minute limit, wait Retry-After seconds.
- `503`: The official source of that country is down or saturated and our copy cannot answer (code SERVICE_UNAVAILABLE). Retry after Retry-After seconds. Free.

---

[API](https://skmtc.dev/catastrogps/apis/catastro-gps-api.md) · [All operations](https://skmtc.dev/catastrogps/apis/catastro-gps-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catastrogps/apis/catastro-gps-api/revisions/1a86d44aa8ae?raw)