{"openapi":"3.2.0","info":{"title":"Mexico ZIP Codes API","description":"Retrieve information of a zip code and search valid zip codes","version":"1.0.0"},"servers":[{"url":"https://mexico-zip-codes.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://mexico-zip-codes.jojapi.net/_jojapi/agent/plans","discovery_url":"https://mexico-zip-codes.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/mexico-zip-codes","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/buscar/":{"get":{"operationId":"get_buscar","summary":"Search zip codes","description":"Search for valid zip codes with starting digits","responses":{"200":{"description":"Response","content":{"application/json":{"schema":{"type":"object","properties":{"codigos_postales":{"type":"array","items":{"type":"string"}}}},"examples":{"Response":{"summary":"Response","value":{"codigos_postales":["64600","64610","64618","64619","64620","64623","64630","64632","64633","64634"]}}}}}}},"parameters":[{"name":"codigo_postal","in":"query","description":"Part of a zip code","required":true,"schema":{"type":"string","example":"646"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number","example":10,"default":10}}]}},"/buscar_por_ubicacion":{"get":{"operationId":"get_buscar_por_ubicacion","summary":"Search zip code by Colonia (optional), Municipio, and Estado","description":"Get all the zip codes for a given Colonia (optional), Municipio, and Estado","responses":{"200":{"description":"Response","content":{"application/json":{"examples":{"Response":{"summary":"Response","value":{"codigos_postales":["64630","64634"]}}}}}}},"parameters":[{"name":"estado","in":"query","required":true,"schema":{"type":"string","example":"Nuevo Leon","default":"Nuevo Leon"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number","example":10,"default":10}},{"name":"municipio","in":"query","required":true,"schema":{"type":"string","example":"monterrey","default":"monterrey"}},{"name":"colonia","in":"query","required":false,"schema":{"type":"string","example":"Colinas de san jeronimo"}}]}},"/codigo_postal/{zip_code}":{"get":{"operationId":"get_codigo_postal_zip_code","summary":"Zip Code Information","description":"Retrieves the information of a particular zip code","responses":{"200":{"description":"Response","content":{"application/json":{"schema":{"type":"object","properties":{"codigo_postal":{"type":"string"},"municipio":{"type":"string"},"estado":{"type":"string"},"colonias":{"type":"array","items":{"type":"string"}}}},"examples":{"Response":{"summary":"Response","value":{"codigo_postal":"64630","municipio":"Monterrey","estado":"Nuevo León","colonias":["San Jemo","Colinas de San Jerónimo","Rincón de San Jemo","Villas de San Jerónimo","La Escondida"]}}}}}}},"parameters":[{"name":"zip_code","in":"path","description":"A zip code","required":true,"schema":{"type":"string","example":"64630"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}