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

# Create vehicle lien

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

Create a new encargo (lien/charge) for a vehicle.

Required fields:
- entidade: Entity name (bank, leasing company, etc.)
- referencia: Reference number/code
- valor: Amount/value of the lien

## Path parameters

- `vehicle_id` integer, required

## Headers

- `x-api-token` string, nullable

## Request body

- EncargoCreate — Encargo (lien/charge) creation request.
  - `entidade` string, required — Entity name (bank, leasing company, etc.)
  - `referencia` string, required — Reference number/code
  - `valor` union, required — Amount/value of the lien
    - number
    - string
  - `marca` string, nullable — Additional notes/mark

## Response `201`

Successful Response

- EncargoResponse — Encargo response with all fields.
  - `ID` integer, required
  - `idviatura` integer, required
  - `entidade` string, required
  - `referencia` string, required
  - `valor` string, required
  - `marca` string, nullable

## 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/4b44eb76b3ee/schema)