PHPackages                             megacreativo/cedulave-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. megacreativo/cedulave-api

ActiveLibrary[HTTP &amp; Networking](/categories/http)

megacreativo/cedulave-api
=========================

CedulaVE API permite consultar datos personales de habitantes de Venezuela inscritos en el CNE mediante su Cédula de Identidad.

v1.1.2(3y ago)261.4k15[1 issues](https://github.com/megacreativo/CedulaVE-API/issues)MITPHPPHP &gt;=5.6

Since Aug 11Pushed 3y ago3 watchersCompare

[ Source](https://github.com/megacreativo/CedulaVE-API)[ Packagist](https://packagist.org/packages/megacreativo/cedulave-api)[ Docs](https://github.com/megacreativo/CedulaVE-API)[ RSS](/packages/megacreativo-cedulave-api/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (3)Dependencies (1)Versions (3)Used By (0)

👋 CedulaVE API
==============

[](#-cedulave-api)

[![GitHub issues](https://camo.githubusercontent.com/b8c9238ad20f13b35457ff0772d3e79dd3af7070e467486dc23188d32b0d80a6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d656761637265617469766f2f436564756c6156452d4150493f7374796c653d666c61742d737175617265)](https://github.com/megacreativo/CedulaVE-API/issues)[![GitHub forks](https://camo.githubusercontent.com/4e31bee6e55292b5b2e8b8d3925bc79e1c70a301147f573ef1434fdac096c6ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d656761637265617469766f2f436564756c6156452d4150493f7374796c653d666c61742d737175617265)](https://github.com/megacreativo/CedulaVE-API/network)[![GitHub license](https://camo.githubusercontent.com/f6381c1f9842fe7c3b2f1e97b78dfa1f898e22deefe2b2c8991e540aff0fa6e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d656761637265617469766f2f436564756c6156452d4150493f7374796c653d666c61742d737175617265)](https://github.com/megacreativo/CedulaVE-API)[![StyleCI](https://camo.githubusercontent.com/65323208d289304be693e052febbe25e6271f35ce5dde1c88e299cd43842e36f/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f39393936383636332f736869656c643f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.styleci.io/repos/99968663)

**CedulaVE API** es un script escrito en *PHP* para consultar datos personales de habitantes de Venezuela inscritos en el *CNE* mediante su Cédula de Identidad.

🤝 Contibución
-------------

[](#-contibución)

[![ko-fi](https://camo.githubusercontent.com/1fedf764fa06114b797ee53e7506df10880abed6766f854202d758df1707969d/68747470733a2f2f7777772e6b6f2d66692e636f6d2f696d672f676974687562627574746f6e5f736d2e737667)](https://ko-fi.com/N4N21DSFZ)

Contribuciones, problemas y solicitudes de funciones son bienvenidos. Siéntase libre de consultar los [issues](https://github.com/megacreativo/CedulaVE-API/issues) si quieres contribuir.

💽 Instalación
-------------

[](#minidisc-instalación)

La forma más fácil de instalar CedulaVE API es a través de [Composer](https://github.com/composer/composer)

```
composer require megacreativo/cedulave-api
```

📜 Ejemplo PHP
-------------

[](#scroll-ejemplo-php)

El método info está disponible para ejecutar la consula, las respuesta se obtiene por defecto en formato JSON

### Consultar la API

[](#consultar-la-api)

Para ver más ejemplos valla a examples

```
/**
 * Estructura de parametros
 *
 * @param string   $nac     Tipo de Nacionalidad. Valores permitidos [V|E]. Cualquier otro valor producirá un Error 301
 * @param string   $cedula  Número de Cédula de Identidad a consultar
 * @param boolean  $json    (Opcional) Si es true devolver JSON como respuesta, en caso contrario devuelve un ARRAY. Valor por defecto TRUE
 * @param boolean  $pretty  (Opcional) Se devuelve un JSON, este parametro establece si se aplica JSON_PRETTY_PRINT. Valor por defecto FALSE
 */
function info(string $nac, string $cedula, bool $json = true, bool $pretty = false)

/**
 * Ejemplos de uso
 **/
// Retorna un JSON
CedulaVE::info('V', '12345678');

// Retorna un Array
CedulaVE::info('V', '12345678', false);

// Retorna un JSON formateado
vCedulaVE::info('V', '12345678', true, true);
```

### Respuesta exitosa

[](#respuesta-exitosa)

```
{
    "status": 200,
    "version": "1.1.1",
    "website": "https://api.megacreativo.com/public/cedula-ve/v1",
    "response":
    {
        "nac": "V", /* Nacionalidad. [V|E] */
        "dni": "12345678", /* Cédula de identidad */
        "name": "Jhon Alfred", /* Primer y segundo nombre */
        "lastname": "Doe Law", /* Primer y segundo apellido */
        "fullname": "Jhon Alfred Doe Law", /* Nombre completo */
        "state": "Estado", /* Estado donde se encuentra el Centro de votación */
        "municipality": "Municipio", /* Municipio del Centro de votación */
        "parish": "Parroquia", /* Parroquia del Centro de votación */
        "voting": "Centro de votación", /* Nombre del Centro de votación */
        "address": "Direccion" /* Dirección del Centro de votación */
    }
}
```

```
Array
(
    [status] => 200
    [version] => 1.1.1
    [api] => https://api.megacreativo.com/public/cedula-ve/v1
    [data] => Array
        (
            [nac] => V
            [dni] => 12345678
            [name] => JHON ALFRED
            [lastname] => DOE LAW
            [fullname] => JHON ALFRED DOE LAW
            [state] => ESTADO
            [municipality] => MUNICIPIO
            [parish] => PARROQUIA
            [voting] => CENTRO DE VOTACION
            [address] => DIRECCION DEL CENTRO
        )

)
```

### Respuestas de error

[](#respuestas-de-error)

**Error 404** La cédula consultada no está inscrita en el CNE

```
{
    "status": 404,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 404,
        "message": "No se encontró la cédula de identidad"
    }
}
```

**Error 301** Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos \[V|E\]

```
{
    "status": 301,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 301,
        "message": "Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos [V|E]"
    }
}
```

**Error 302** Los datos recibidos no son correctos. Se introdujo un caracter no numerico

```
{
    "status": 302,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 302,
        "message": "Los datos recibidos no son correctos. Se introdujo un caracter no numerico"
    }
}
```

**Error 303** Los datos recibidos no son correctos. Se introdujo un caracter no numerico

```
{
    "status": 303,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 303,
        "message": "Debe ingresar una cedula de indetidad válida. Sólo se permiten caracteres numéricos"
    }
}
```

👤 Author
--------

[](#-author)

**Brayan Rincón**

- Github: \[@bracodev\]\[link-bracodev\]

📌 Versiones
-----------

[](#-versiones)

We use [SemVer](http://semver.org/) for versioninWg. For all available versions, look at the [tags in this repository](https://github.com/tu/proyecto/tags).

📝 Licencia
----------

[](#-licencia)

The software is distributed under the [MIT license](https://github.com/megacreativo/CedulaVE-API/master/LICENSE). Copyright © 2018-2020. Made with ❤️ by Brayan Rincon &amp; MegaCreativo

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1929 days

Total

2

Last Release

1315d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/94016346?v=4)[megacreativo](/maintainers/megacreativo)[@megacreativo](https://github.com/megacreativo)

---

Top Contributors

[![bracodev](https://avatars.githubusercontent.com/u/25647752?v=4)](https://github.com/bracodev "bracodev (33 commits)")

---

Tags

curlphpphp-libraryapivenezuelacedulaDNIcnemega creativomegacreativoconsejo nacional electoral

### Embed Badge

![Health badge](/badges/megacreativo-cedulave-api/health.svg)

```
[![Health](https://phpackages.com/badges/megacreativo-cedulave-api/health.svg)](https://phpackages.com/packages/megacreativo-cedulave-api)
```

###  Alternatives

[xendit/xendit-php

Xendit PHP SDK

191806.3k8](/packages/xendit-xendit-php)[angelleye/paypal-php-library

PHP wrapper for PayPal APIs

242449.5k](/packages/angelleye-paypal-php-library)[infobip/infobip-api-php-client

PHP library for consuming Infobip's API

931.9M10](/packages/infobip-infobip-api-php-client)[onesignal/onesignal-php-api

A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com

34199.5k2](/packages/onesignal-onesignal-php-api)[labs64/netlicensingclient-php

PHP wrapper for Labs64 NetLicensing RESTful API

1450.8k1](/packages/labs64-netlicensingclient-php)[mediamonks/rest-api-bundle

MediaMonks Rest API Symfony Bundle

1656.2k1](/packages/mediamonks-rest-api-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
