Postal Data API
for LuumenAI

Check and resolve postal codes across 240+ countries, without leaving the terminal

Ask whether a postal code exists, what city and region it belongs to, and where it sits. POSTAL_DATA_API_LOOKUP_POSTAL_CODE and POSTAL_DATA_API_GET_POSTAL_CODE_METADATA return coordinates, timezone, and administrative detail; POSTAL_DATA_API_VALIDATE_POSTAL_CODES_BULK checks up to 1,000 codes at once, including mixed-country batches. Connect with an API key. Every tool here is read-only, so answers come back immediately.

The Postal Data API toolbox

6 tools, all read-only. They answer instantly, and every call is logged.

  • ReadGet API InformationReturn Postal Data API version, coverage, usage guidance, current balance, and configured rate-limit status when returned, for connectivity or service discovery.
  • ReadGet Postal Code MetadataReturn all available country-specific metadata for a postal code, such as coordinates, timezone, county, elevation, and administrative levels.
  • ReadLook Up Postal CodeLook up the city, region, and coordinates for a postal code.
  • ReadSearch Postal Codes by CityReturn all postal codes matching a city and optional region, including fuzzy-match details.
  • ReadValidate Postal CodeCheck whether one postal code exists without treating a nonexistent code as an execution error.
  • ReadValidate Postal Codes in BulkValidate 1 to 1,000 postal codes synchronously, including mixed-country batches.

Questions

How does LuumenAI connect to Postal Data API?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Postal Data API on its own?

No. Every one of the 6 tools LuumenAI has for Postal Data API is read-only, so it can answer questions from Postal Data API but cannot change anything in it. Reads are not gated — they answer immediately, and each one is recorded on the audit trail with the actor and the result.

Who gets access to the integration?

You decide. Access is granted per agent, skill, and team, and per environment — production is not staging.

Is there an audit trail?

Every call to Postal Data API is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Postal Data API to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.