---
title: "List colonies for a Mexican postal code"
method: GET
path: "/api/public/v1/mx/colonies"
tags: ["Colonies"]
---

# List colonies for a Mexican postal code

`GET /api/public/v1/mx/colonies`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/public/v1/mx/colonies`
- Auth: HTTP basic

Returns colony names, municipality, city and state for a given 5-digit Mexican postal code

## Query parameters

- `postal_code` string, required

## Headers

- `Authorization` string, required

## Response `200`

postal code not found in Multiburó

## Other responses

- `400`: invalid postal code
- `401`: unauthorized
- `502`: Multiburó service error
- `504`: Multiburó service timeout

---

[API](https://skmtc.dev/sequra/apis/instore-api.md) - [All operations](https://skmtc.dev/sequra/apis/instore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequra/apis/instore-api/revisions/29430b803abc?raw)