Skip to main content
POST
Consultar organizaciones en lote

Authorizations

Authorization
string
header
required

La API key de tu organización, con la forma rvm_<prefijo>.<secreto>, enviada como Authorization: Bearer rvm_…. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera.

Body

application/json

Cuerpo máximo 32 KiB. Los atributos se validan una vez por solicitud; cualquier ID desconocido, ajeno, de otra entidad o del simulador rechaza la solicitud con 422.

tax_ids
string[]
required

Entre 1 y 100 identificadores tributarios. Se normalizan como los endpoints individuales, conservando ceros. Duplicados permitidos: un resultado por posición.

Required array length: 1 - 100 elements
Required string length: 1 - 100
attribute_ids
string[]

Hasta 100 IDs distintos, como strings decimales positivos. Omitido o [] no solicita atributos. Todos deben definir atributos de organización del tenant autenticado.

Maximum array length: 100
Pattern: ^[1-9]\d{0,18}$

Response

Resultados en orden de entrada.

Máximo 1 MiB de JSON UTF-8. Si lo supera, responde 413 sin truncar valores; reduce el lote o la selección.

attribute_definitions
object[]
required

Metadatos compartidos de los IDs solicitados, en el orden solicitado: id, name, data_type y extra_data (opciones de select cuando corresponde).

Maximum array length: 100
results
object[]
required

Un resultado por posición con index desde 0 y tax_id normalizado. found incluye sólo id, tax_id, name nullable y attributes por ID. Una clave ausente no tiene valor almacenado; null es un borrado explícito; 0 y money.amount: 0 son valores. not_found incluye faltantes, papelera, simulador y otros tenants sin distinguirlos.

Maximum array length: 100