Query Electronic File

POST

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

Query Electronic File

This endpoint allows you to query a specific file within the Electronic Signature flow to get its current details, processing status, and associated metadata.

Authorization

This resource is protected. You must include your access token in the request header.

Parameter	Type	Description	Limits
`Authorization`	string	Access token (Bearer token).	Required
`Content-Type`	string	Specifies the request format.	application/json

Authorization

string

Access token (Bearer token).

Limits:Required

Content-Type

string

Specifies the request format.

Limits:application/json

Request Parameters

Required Fields

Fields marked with an asterisk (*) are required and must be provided in the request. Other fields are optional.

Send the file identifier in JSON format to perform the query.

Parameter	Type	Description	Limits
`archivo_id`	string	Unique identifier (UUID) of the file you want to query.	Required (UUID format)

archivo_id

string

Unique identifier (UUID) of the file you want to query.

Limits:Required (UUID format)

Implementation Examples

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));

Status Codes

Code	Status	Description
`200`	OK	Query performed successfully.
`400`	Bad Request	Invalid parameters or incorrect JSON format.
`401`	Unauthorized	Missing or invalid token.
`404`	Not Found	No file found with the provided ID.
`500`	Server Error	Internal server failure.