Postal Data API

Validate and look up postal codes during calls, in 240+ countries.

Postal Data API checks postal codes, cities, regions and coordinates across more than 240 countries and territories. Connect it to AgentCalls and your agent can confirm a caller's postal code, find the right city or region, and check that an address is real before it books a visit or quotes a delivery. Your agent can also pull country-specific details such as timezone or county when a call needs them. Each lookup uses one query from your Postal Data API balance.

What your agent can do with Postal Data API

  • Validate a postal code while the caller is still on the line
  • Look up the city, region and coordinates for a postal code
  • Find all postal codes for a city, including US state matching
  • Check many postal codes at once for customer or order lists

Postal Data API exposes 6 actions. You choose which ones the agent may use and whether each runs during or after the call.

Example calls

Booking a service visit with a postal code check

  1. Caller

    Hi, I need someone to look at my boiler. I'm in Leeds, postcode LS6 1AB.

  2. Agent

    Thanks for calling. Let me confirm that postcode for you. Yes, LS6 1AB is in Leeds. Which day suits you?

  3. Caller

    Thursday morning if possible.

  4. Agent

    Thursday at 9:00 is open. I've booked a boiler check for you at 14 Hyde Park Road, Leeds.

Finding a city from a ZIP code

  1. Caller

    I'm trying to order flowers for my mom in Ohio. The zip is 44101.

  2. Agent

    Got it. Zip 44101 is Cleveland, Ohio. Should I send the order to Cleveland?

  3. Caller

    Yes, please. And can you tell me if the zip is correct for downtown?

  4. Agent

    Cleveland 44101 covers the downtown area, so your delivery address will be valid. Shall I place the order now?

Following up a quote for a delivery area

  1. Agent

    Hello, this is calling from Harbor Pantry about your catering request. We can deliver to your area. Can I confirm your postal code?

  2. Caller

    Sure, it's 2000 in Sydney. Can you actually deliver there?

  3. Agent

    Postcode 2000 is in our delivery zone, so yes. Would you like me to send the quote to your email now?

How to connect Postal Data API

  1. 1

    Create your agent

    Sign up to AgentCalls, pick an English or Arabic voice and write what the agent should know and do in plain language.

  2. 2

    Connect Postal Data API

    From Integrations in the dashboard, choose Postal Data API and enter the connection details from your Postal Data API account settings.

  3. 3

    Choose the actions

    In the agent editor, enable the Postal Data API actions the agent may use and set each to run during the call or afterwards. Then test it from your browser.

Questions, answered.

Does it work during the call or after it?

Both. Your agent can validate and look up postal codes while a caller is on the line, and it can run checks as part of follow-up calls or after a call ends.

What do I need to connect Postal Data API?

You need an account with Postal Data API and your own credentials from its settings. Sign in from the AgentCalls dashboard and add the connection under Tools. Integrations are included from the Growth plan.

Do lookups use my Postal Data API balance?

Yes. Each successful lookup or validation uses one query from your Postal Data API balance. Bulk checks use one query per postal code.

Page drafted from the tool's public description and reviewed automatically for accuracy of claims

Put your agent to work with Postal Data API.

Connect in minutes, test from your browser, go live on a number in the US, UK or Gulf. Free to start, no card needed.