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 a single applicant from the Firestore postulantes collection by matching the provided :id path parameter against Firestore document IDs. If a matching document is found, the response includes the document id merged with all stored fields. This route is public — no authentication token is required.
The lookup is performed by scanning all documents in the postulantes collection and finding the one whose doc.id matches the given :id. If no document matches, a 404 is returned.

Endpoint

MethodGET
Path/api/postulantes/:id
AuthNone

Path parameters

id
string
required
The Firestore document ID of the applicant to retrieve. This value is the auto-generated ID assigned by Firestore when the record was created.

Responses

200 OK

Returns the full applicant object for the matching document.
id
string
The Firestore document ID of the applicant.
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 (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 applied for.
application_date
string | Date
Timestamp of when the application was submitted.
status
string
Current status of the application (e.g. "pending", "reviewed").

404 Not Found

Returned when no document in the postulantes collection matches the given :id.
{ "message": "User not found" }

500 Internal Server Error

Returned when the Firestore query fails unexpectedly.
{ "message": "Error fetching user", "error": "..." }

Example

Request

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

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"
}

Response — 404 Not Found

{ "message": "User not found" }

Build docs developers (and LLMs) love