Get started

    API Endpoint

    http://tseapi.savaldev.com/api/v2/cedula/:cedula
                

TSE API provides Costa Rican citizen information. You can use this API to get public information about a citizen by its cedula number. This is and unofficial API and it's not related to the TSE. Our team is not responsible for the use of this API.

By cedula

# Here is a fetch request example
fetch('http://tseapi.savaldev.com/api/v2/cedula/:cedula')
    .then(response => response.json())
    .then(data => console.log(data));



                

To get citizen information, you need to make a GET request to the following endpoint with the cedula number as a parameter: :
http://tseapi.savaldev.com/api/v2/cedula/:cedula

Result example :

{
    "cedula": "000000000",
    "nombre": "JHON",
    "primerApellido": "DOE",
    "segundoApellido": "SMITH",
    "fechaNacimiento": "20/03/2040"
}
                

QUERY PARAMETERS

Field	Type	Description

Errors

The Westeros API uses the following error codes:

Error Code	Meaning
500	Internal Server Error -- We had a problem with our server. Try again later.
404	No user associated with given cedula. Also invalid endpoints request.
400	Bad Request -- Your request is invalid. Cedula number is missing or invalid.