Time	Status	User Agent
Retrieving recent requests…

Intro

This API lets you search for a movable property guarantee in the oficial site Registro Único de Garantías

This service is asynchronous because you can get more than one result, and the search may take longer depending on the amount of data retrieved. Therefore, once the request is made, you will receive a response with a pending status. To see the service's response, you must use the GET endpoint to obtain the response once all the data has been processed.

Important points

Required parameters

The vault parameter in the request body is required. This value must be the name of your credentials stored in the Vault Links section

In addition to the credentials, it will be necessary to indicate at least the electronic folio, guarantee number, or if you wish to search by type of individual or legal entity, their name or company name.

The buscarDetalle field is used to request all information related to the guarantee.

Request examples

Individual

{
    "vault": "rug",
    "tipoOtorgante": "PF",
    "nombre": "Rodrigo",
    "apellidoPaterno": "Hernandez",
    "apellidoMaterno": "Castro",
    "curp": "",
 		"rfc": "",
		"buscarDetalle": true

}

Legal entity

{
    "vault": "rug",
    "tipoOtorgante": "PM",
    "razonSocial": "Agricola RDRG SA de CV",
    "rfc": "",
  	"buscarDetalle": true

}

Guarantee number

{
    "vault": "rug",
    "numeroGarantia": "12345678"
}

Electronic folio

{
    "vault": "rug",
    "folioElectronico": "X000000000XX0"
}

descripcionBienes

{
    "vault": "rug",
    "tipoOtorgante": "PF",
    "nombre": "Rodrigo",
    "descripcionBienes": "automotriz"
}

Response

You can find an examples of the different kinds of responses in the examples of the call.

Response fields

Field	Type	Description
`acreedor`	`string`	Full legal name of the creditor holding the guarantee. May include the entity's role, such as trustee (fiduciario) and trust number.
`descripcion`	`string`	Free-text description of the guarantee. Provides additional context about the assets or rights covered.
`deudores`	`array`	List of debtors associated with the guarantee. Can be empty if no debtors are registered.
`fechaInscripcion`	`string`	Date and time when the guarantee was officially registered. Format: `YYYY-MM-DD HH:MM:SS`.
`folioElectronico`	`string`	Unique electronic folio assigned by the RUG. Primary identifier of the guarantee record.
`monto`	`string`	Monetary value of the guarantee, including amount and currency (e.g., Mexican Peso).
`numeroGarantia`	`string`	Internal guarantee number assigned by the RUG.
`numeroOperacion`	`string`	Operation number associated with the transaction that originated or modified the guarantee.
`operacion`	`string`	Procedure performed on the record. Common values: `Certificación`, `Cancelación`, `Modificación`.
`otorgante`	`string`	Full legal name of the primary grantor. Shorthand string of the main entry in `otorgantes`.
`otorgantes`	`array<object>`	List of all grantors. See Otorgante Object below.
`tipoBienes`	`string`	Category of assets covered, such as rights, movable property, or collection rights.
`tipoGarantia`	`string`	Guarantee subtype. Examples: `Factoraje Financiero`, `Prenda`, `Fideicomiso de Garantía`.
`tipoOperacion`	`string`	Nature of the registry operation. Values: `INSCRIPCIÓN`, `MODIFICACIÓN`, `CANCELACIÓN`.
`urlOperacion`	`string (URL)`	URL to the official RUG portal for this record. Visiting this link will provide the official PDF certificate of the guarantee issued by the Secretaría de Economía.
`vigencia`	`string`	Validity duration of the guarantee, expressed in months (e.g., `120 Meses`).

Otorgante Object

Fields within each object in the otorgantes array:

Field	Type	Description
`folioElectronico`	`string`	Electronic folio of this grantor within the registry.
`nombreRazonDenominacionSocial`	`string`	Full legal name or corporate name (razón social) of the grantor.
`tieneRfc`	`string`	Indicates whether the grantor has a registered RFC (Mexican tax ID). Values: `Si cuenta con RFC` / `No cuenta con RFC`.
`tipoPersona`	`string`	Legal person type. Values: `Persona Moral` (Legal Entity) or `Persona Física` (Individual).

Required field

You will get a 400 bad request error when the vault parameter is not provided or doesn't exist in the body request.

[
    {
        "code": "REQUIRED_FIELD_ERROR",
        "message": "EMPTY_ERROR  can't be empty",
        "field": "vault"
    }
]

[
    {
        "message": "Las credenciales de RUG no están configuradas en Vault",
        "field": "vault"
    }
]

You will get a 400 bad request error when a field parameter is not provided when tipoOtorgante have value

[
    {
        "code": "REQUIRED_FIELD_ERROR",
        "message": "EMPTY_ERROR  can't be empty",
        "field": "razonSocial"
    }
]

[
    {
        "code": "REQUIRED_FIELD_ERROR",
        "message": "At least one search parameter is required: nombre, apellidoPaterno, apellidoMaterno, curp, razonSocial, rfc, numeroGarantia, folioElectronico",
        "field": "searchParameters"
    }
]

Invalid format

You will get a 400 bad request error when the curp parameter does not comply with the correct format

[
    {
        "code": "FORMAT_ERROR",
        "message": "wrong type, wanted: string",
        "field": "nombre"
    }
]

[
    {
        "code": "FORMAT_ERROR",
        "message": "wrong type, wanted: string",
        "field": "apellidoPaterno"
    }
]

[
    {
        "code": "FORMAT_ERROR",
        "message": "wrong type, wanted: string",
        "field": "apellidoMaterno"
    }
]

[
    {
        "code": "FORMAT_ERROR",
        "message": "must match ^([A-Z]{1,2})(\\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01]))([A-Z\\d]{3})([A-Z\\d])$",
        "field": "curp"
    },
    {
        "code": "FORMAT_ERROR",
        "message": "must match ^([A-Z]{3,4})(\\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\\d|3[01]))([A-Z\\d]{3})$",
        "field": "rfc"
    }
]

[
    {
        "code": "FORMAT_ERROR",
        "message": "wrong type, wanted: string",
        "field": "razonSocial"
    }
]

Catalog error

You will get a 400 bad request error when any value don't belongs for the possible values in a catalog

[
    {
        "code": "FORMAT_ERROR",
        "message": "Tipo de otorgante inválido. Valores permitidos: PF, PM",
        "field": "tipoOtorgante"
    }
]

Conditional Parameter Error

[
  {
          "code": "CONFLICT_ERROR",
          "message": "La razón social no aplica para Persona Física",
          "field": "razonSocial"
  }
]

[
    {
        "code": "CONFLICT_ERROR",
        "message": "El nombre no aplica para Persona Moral",
        "field": "nombre"
    },
    {
        "code": "CONFLICT_ERROR",
        "message": "Los apellidos no aplican para Persona Moral",
        "field": "apellidos"
    },
    {
        "code": "CONFLICT_ERROR",
        "message": "La CURP no aplica para Persona Moral",
        "field": "curp"
    }
]