Consultar Archivo Electrónico

POST

https://app.firmeasy.legal/api/v1/electronica/archivo/consulta

Consultar Archivo Electrónico

Este endpoint te permite realizar una consulta sobre un archivo específico dentro del flujo de Firma Electrónica para obtener sus detalles actuales, estado de procesamiento y metadatos asociados.

Autorización

Este recurso está protegido. Debes incluir tu token de acceso en el encabezado de la petición.

Parámetro	Tipo	Descripción	Límites
`Authorization`	string	Token de acceso (Bearer token).	Obligatorio
`Content-Type`	string	Especifica el formato de la petición.	application/json

Authorization

string

Token de acceso (Bearer token).

Límites:Obligatorio

Content-Type

string

Especifica el formato de la petición.

Límites:application/json

Parámetros de la Petición

Campos Obligatorios

Los campos marcados con un asterisco (*) son obligatorios y deben ser proporcionados en la solicitud. Los demás campos son opcionales.

Envía el identificador del archivo en formato JSON para realizar la consulta.

Parámetro	Tipo	Descripción	Límites
`archivo_id`	string	Identificador único (UUID) del archivo que deseas consultar.	Obligatorio (Formato UUID)

archivo_id

string

Identificador único (UUID) del archivo que deseas consultar.

Límites:Obligatorio (Formato UUID)

Ejemplos de Implementación

cURL

curl -X POST [https://app.firmeasy.legal/api/v1/electronica/archivo/consulta](https://app.firmeasy.legal/api/v1/electronica/archivo/consulta) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "archivo_id": "fa8ae959-72b9-4047-a481-15134a86eb67"
  }'

Node.js (Fetch)

const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer TU_TOKEN_AQUI");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "archivo_id": "fa8ae959-72b9-4047-a481-15134a86eb67"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("[https://app.firmeasy.legal/api/v1/electronica/archivo/consulta](https://app.firmeasy.legal/api/v1/electronica/archivo/consulta)", requestOptions)
  .then((response) => response.json())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Códigos de Estado

Código	Estado	Descripción
`200`	OK	Consulta realizada correctamente.
`400`	Bad Request	Parámetros inválidos o formato de JSON incorrecto.
`401`	Unauthorized	Token ausente o inválido.
`404`	Not Found	No se encontró el archivo con el ID proporcionado.
`500`	Server Error	Falla interna en los servidores.