Saltar al contenido

Si hay stock, se puede pedir como máximo la cantidad disponible; si no hay stock (pedido anticipado), al menos 250 unidades. El campo sufficient indica si se puede cubrir la cantidad que quieres.

Si no envías target_url, se devuelve el stock del modo de todos los sitios; es la misma cifra que en la respuesta de GET /locations. target_url debe ser uno de los destinos compatibles (GET /target-urls); si no lo es, devuelve 400 y details.unsupported_targets, igual que el endpoint de pedidos.

Un location_id desconocido devuelve 400. Si el tipo de servicio está en mantenimiento, llegan maintenance: true y sufficient: false.

Autorización

Authorizationstringobligatorio

Se envía como Bearer <token>. Este endpoint requiere el permiso orders:read (Información de servicios); un token sin él recibe 403.

Parámetros de consulta

typeenum<string>obligatorio

Tipo de servicio.

location_idintegerobligatorio

Identificador de la ubicación. Obtenlo del endpoint GET /locations.

quantityinteger

Cantidad de IP (1-1000).

target_urlstring

Dominio de destino para un pedido por destinos; el stock se calcula para ese destino.

Respuesta

200
application/json
dataobject