---
title: "Consultar candidatos de referencia en lote"
method: POST
path: "/api/v1/reference-candidates/query"
tags: ["API"]
---

# Consultar candidatos de referencia en lote

`POST /api/v1/reference-candidates/query`

## Request

- Base URL: `https://api.lapyme.com.ar`
- URL: `https://api.lapyme.com.ar/api/v1/reference-candidates/query`
- Auth: HTTP bearer

Consulta de solo lectura, sin efectos durables ni Idempotency-Key. Autentica una vez y aplica las mismas reglas de kind, scopes y catálogo que GET /api/v1/reference-candidates. Acepta de 1 a 25 textos, recorta espacios y devuelve un resultado por posición, incluidas las repeticiones, con índice desde cero y hasta seis candidatos por texto.

## Query parameters

- `kind` 'account' | 'category' | 'cost_center' | 'customer' | 'inventory_category' | 'inventory_product_variant' | 'inventory_product_variant_group' | 'inventory_warehouse' | 'payment_method' | 'point_of_sale' | 'price_list' | 'product_variant' | 'product_variant_group' | 'register' | 'safe' | 'seller' | 'supplier' | 'tag' | 'tag_customer' | 'tag_supplier' | 'tag_product' | 'tag_sale' | 'tag_purchase' | 'tag_purchase_order' | 'tag_transfer' | 'warehouse', required

## Request body

- object
  - `queries` string[], required

## Response `200`

Candidatos por posición

- ApiReferenceCandidateQueryResponse
  - `request_id` string, required
  - `object` 'list', required
  - `url` string, required
  - `data` object[], required
    - `index` integer, required
    - `candidates` ApiReferenceCandidate[], required
      - `object` 'reference_candidate', required
      - `id` string, uuid, required
      - `label` string, nullable, required
      - `detail` string, nullable, required
      - `exact_match` boolean, required
      - `is_default` boolean
  - `has_more` false, required
  - `next_cursor` string, nullable

## Other responses

- `400`: Solicitud inválida
- `401`: Autenticación requerida
- `403`: Scope insuficiente
- `500`: Error interno
- `503`: Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-16** `b234c06ea2fd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/reference-candidates/query/post.md)

---

[API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/95facfb6b9b7?raw)
