apis.gometa.org documentation

• UPDATE: este API de cedulas ahora tambien es un 'cache' para el API oficial de Hacienda. Funcioan de la siguiente forma:
  • Si no tengo la cedula en el cache, pregunto a Hacienda, lo guardo en cache y lo devuelvo.
  • Si tengo la cedula en el cache con una antiguedad menos de 7 dias, devuelvo de cache.
  • Si el cache es mas viejo que 7 dias, trato de obtenerlo de Hacienda otra vez. Si Hacienda falla, devuelvo del cache sin importar la edad.
• Simply send a GET request to https://apis.gometa.org/cedulas/[YOUR QUERY HERE], and you'll get some JSON back with your search results.
• It really couldn't be any simpler, I think.
• You can search for cédulas jurídicas, físicas or using words.
• When searching for cédulas, you can include the old 2-digit checksum at the end but you don't have to.
• If you're searching for words, only full-word matches will be returned, and words shorter than 4 characters will be ignored.
• The current request limit is 20 requests per IP per 5 minutes. You can get an API key at https://apis.gometa.org/cedulas/signup if you need more.
• This is a free service, using publically available data that was licensed to 'los contribuyentes de Costa Rica'.
• I make no guarantees of any part of the functioanlity or the results of this service, either explicit or implied. Use at your own risk.
• If you need additional help just send me an email to: apis@gometa.org.
• Requests served so far: millions.
• Este servidor ha sido donado por CyberFuel. Muchas gracias!
• Si quiere, me puede ayudar con el costo mensual de este servicio:
  
  o via SINPE movil al 8828-8803

known bugs / to-do

• fix encoding issues. Go UTF8 everywhere
• allow 3-character word searches
• maybe ignore 'S.A.' and similar things when searching