---
title: "Request lien certificate"
method: POST
path: "/api/vehicles/{vehicle_id}/encargos/request"
tags: ["Encargos (Liens/Charges)"]
---

# Request lien certificate

`POST /api/vehicles/{vehicle_id}/encargos/request`

Request a lien certificate from external API.

This calls the external service (http://13.36.175.211:8097/ask_pedido_certidao)
to retrieve lien/charge data for a vehicle.

The response contains the status and any data returned from the external service.

## Path parameters

- `vehicle_id` integer, required

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- LienCertificateResponse — Response from external lien certificate API.
  - `status` string, required — Status of the request (success/error)
  - `reference` string, nullable — Reference number if successful
  - `message` string, nullable — Error or status message
  - `data` object, nullable — Additional data returned

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/8492136eefc5/schema)