Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Manuelfg1985/Proyecto_Final_26/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint fetches every record from the Firestore postulantes collection and returns them as a JSON array. Each object in the array includes the Firestore-generated document id alongside all applicant fields. This route is public — no authentication token is required to call it.
This endpoint is defined directly in index.js and uses the Firebase SDK’s getDocs(collection(db, 'postulantes')) call. Each document’s id is merged with its field data before the response is sent.

​
Endpoint

MethodGET
Path/api/postulantes
AuthNone

​
Response

​
200 OK

Returns an array of applicant objects. Each object contains the Firestore document ID plus all stored fields.
​
id
string
Auto-generated Firestore document ID. Unique identifier for the applicant record.
​
name
string
First name of the applicant.
​
surname
string
Last name (surname) of the applicant.
​
email
string
Email address of the applicant.
​
birthdate
string
Date of birth of the applicant, stored as a string (e.g. "1990-05-15").
​
telephone
string
Contact telephone number of the applicant.
​
city
string
City of residence of the applicant.
​
province
string
Province of residence of the applicant.
​
applied_position
string
Job position the applicant has applied for.
​
application_date
string | Date
Timestamp of when the application was submitted. Defaults to the date/time the record was created.
​
status
string
Current status of the application. Defaults to "pending".

​
Error responses

StatusBody
500 Internal Server Error{ "mensaje": "❌ Error de conexión", "error": "<message>" }
The 500 error is returned when the Firestore query fails — for example, due to a misconfigured database connection or a network issue.

​
Example

​
Request

curl https://proyecto-final-26-6tn2.vercel.app/api/postulantes

​
Response — 200 OK

[
  {
    "id": "abc123XyZ",
    "name": "María",
    "surname": "González",
    "email": "[email protected]",
    "birthdate": "1990-05-15",
    "telephone": "+54 11 1234-5678",
    "city": "Buenos Aires",
    "province": "Buenos Aires",
    "applied_position": "Frontend Developer",
    "application_date": "2024-06-01T10:30:00.000Z",
    "status": "pending"
  },
  {
    "id": "def456AbC",
    "name": "Carlos",
    "surname": "Ramírez",
    "email": "[email protected]",
    "birthdate": "1985-11-22",
    "telephone": "+54 351 9876-5432",
    "city": "Córdoba",
    "province": "Córdoba",
    "applied_position": "Backend Developer",
    "application_date": "2024-06-03T14:00:00.000Z",
    "status": "reviewed"
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us