DOCUMENTACIÓN · HELPMAPS

API pública

Solo lectura · sin llave · CORS abierto · 60 peticiones por minuto por IP.

Cada despliegue de HelpMaps publica sus puntos de ayuda en el mismo formato, así que quien integra un país los integra todos. Los datos se ofrecen bajo CC BY 4.0: úsalos citando la fuente.

Un punto de tipo digital es una iniciativa real sin sede física: llega con lat y lng en null y dice dónde ayuda en coverage_regions (códigos de región; vacío = todo el país). El filtro ?region= la incluye si atiende esa región. No mandes a nadie a sus coordenadas: no las tiene.

Endpoint

GET https://www.helpmapvzla.net/api/v1/centers

Documento OpenAPI 3.1 generado por cada despliegue: /api/v1/openapi.json

Parámetros

Parámetro	Valores	Qué hace
region	código de estado (24 disponibles)	Filtra por división administrativa.
type	shelter · donation_centre · comedor · iniciativa · digital · hospital	Tipo de punto.
needs	true	Solo puntos que piden algo y no están cerrados.
status	abierto · lleno · cerrado	Estado operativo del punto.
limit / offset	hasta 500 / entero	Paginación. La respuesta trae `next` cuando hay más.

Ejemplo

curl "https://www.helpmapvzla.net/api/v1/centers?needs=true&limit=2"

{
  "country": { "code": "VE", "name": "Venezuela", "slug": "ve" },
  "count": 37,
  "limit": 2,
  "offset": 0,
  "next": "needs=true&limit=2&offset=2",
  "data": [
    {
      "id": "she_ejemplo_a1b2",
      "name": "Refugio de ejemplo",
      "type": "shelter",
      "region": "amazonas",
      "lat": 0, "lng": 0,
      "status": null,
      "needs": "Agua, colchonetas",
      "receives": ["agua", "ropa"],
      "help": ["voluntariado", "especie"],
      "last_confirmed_at": "2026-08-09T14:02:00Z",
      "url": "https://www.helpmapvzla.net/c/she_ejemplo_a1b2"
    }
  ]
}

Dos cosas que hay que respetar

`status: null` significa desconocido, no abierto. Si tu aplicación lo pinta como disponible, va a mandar gente a puertas cerradas. Trátalo como «sin confirmar».
Muestra la fecha. `last_confirmed_at` y `updated_at` son parte del dato: una necesidad de hace tres semanas es una suposición, no información.

Los campos help aceptan: voluntariado · especie · oficios · difusion · economico.

Documentación Ir al mapa