---
title: "Preview records for one country"
method: GET
path: "/ajax-preview"
tags: ["Search"]
---

# Preview records for one country

`GET /ajax-preview`

Returns up to 25,000 postal-code records for a country preview modal. For large imports, use country downloads instead of repeated live requests.

## Query parameters

- `country` string, required

## Response `200`

Preview rows for the requested country, or an error object if the country is invalid.

- union
  - PostalRecord[]
    - `country_code` string — ISO 3166-1 alpha-2 country code.
    - `postal_code` string — Postal identifier as text. It may contain leading zeroes, spaces, letters or punctuation.
    - `place_name` string
    - `admin_name1` string, nullable
    - `admin_name2` string, nullable
    - `admin_name3` string, nullable
    - `latitude` number, nullable — Approximate locality or area centroid, not a delivery-point coordinate.
    - `longitude` number, nullable — Approximate locality or area centroid, not a delivery-point coordinate.
  - Error
    - `error` string

---

[API](https://skmtc.dev/postalcodes/apis/postalcodes-info-postal-code-reference-api.md) · [All operations](https://skmtc.dev/postalcodes/apis/postalcodes-info-postal-code-reference-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/postalcodes/postalcodes-info-postal-code-reference-api/revisions/d98a4c6d6ad6/schema)