> ## Documentation Index > Fetch the complete documentation index at: https://developers.tiendadepuntos.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar ítems de puntos > Devuelve los ítems de puntos del comercio, paginado. El `id` de cada ítem es lo que después mandás para pedir la simulación de puntos. Si enviás el header `x-branch-id`, devuelve los ítems de esa sucursal más los que aplican a todo el comercio. **Atención**: este endpoint devuelve `{ data, meta, links }` en la raíz, sin el envelope `{ success, status, message, data }`. ## OpenAPI ````yaml /api-reference/openapi.json get /external/point-items openapi: 3.0.0 info: title: API de Tienda de Puntos description: >- API pública de Tienda de Puntos. Permite sumar puntos por compra, consultar clientes, validar canjes y consumir cupones desde tu POS, ERP o e-commerce. Todas las llamadas se autentican con el header `x-api-key`. version: 0.0.1 contact: {} servers: - url: https://api.tiendadepuntos.com description: Producción - url: https://apidev.tiendadepuntos.com description: QA security: - ApiKeyAuth: [] tags: [] paths: /external/point-items: get: tags: - Ítems de puntos summary: Listar ítems de puntos description: >- Devuelve los ítems de puntos del comercio, paginado. El `id` de cada ítem es lo que después mandás para pedir la simulación de puntos. Si enviás el header `x-branch-id`, devuelve los ítems de esa sucursal más los que aplican a todo el comercio. **Atención**: este endpoint devuelve `{ data, meta, links }` en la raíz, sin el envelope `{ success, status, message, data }`. operationId: ExternalPointItemController_findAll parameters: - name: order required: false in: query description: Campo por el que ordenar. schema: type: string enum: - name - points - amount - createdAt - name: x-branch-id in: header description: >- ID de la sucursal en la que se registra la operación. Si se omite, la operación queda asociada al comercio sin sucursal. required: false schema: type: integer example: 1972 - name: page required: false in: query schema: type: integer minimum: 1 default: 1 example: 1 - name: limit required: false in: query description: Cantidad de resultados por página. Máximo 200. schema: type: integer minimum: 1 maximum: 200 default: 10 example: 10 - name: query required: false in: query description: Búsqueda parcial por nombre. schema: type: string example: café - name: direction required: false in: query description: Sentido del orden. Solo aplica si se envía `order`. schema: type: string enum: - asc - desc default: desc responses: '200': description: Página de ítems de puntos. Sin envelope. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/ExternalPointItemOutputDto' meta: type: object properties: totalItems: type: integer example: 128 itemCount: type: integer example: 10 itemsPerPage: type: integer example: 10 totalPages: type: integer example: 13 currentPage: type: integer example: 1 from: type: integer example: 1 to: type: integer example: 10 links: type: object properties: first: type: string example: external/point-items?page=1&limit=10 previous: type: string example: null nullable: true next: type: string nullable: true example: external/point-items?page=2&limit=10 last: type: string example: external/point-items?page=13&limit=10 path: type: string example: external/point-items firstPageUrl: type: string example: external/point-items?page=1&limit=10 lastPageUrl: type: string example: external/point-items?page=13&limit=10 '400': description: El cuerpo o los parámetros no pasaron la validación. content: application/json: schema: type: object properties: statusCode: type: integer example: 400 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Error de validación errors: type: array nullable: true items: type: object data: type: object nullable: true '401': description: >- Falta el header `x-api-key` (`Api Key is required`), o está presente pero no corresponde a ningún comercio (`Api key is invalid`). content: application/json: schema: type: object properties: statusCode: type: integer example: 401 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Api key is invalid errors: type: array nullable: true items: type: object data: type: object nullable: true '404': description: La key es válida y el recurso pedido no existe. content: application/json: schema: type: object properties: statusCode: type: integer example: 404 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Client not found errors: type: array nullable: true items: type: object data: type: object nullable: true security: - ApiKeyAuth: [] components: schemas: ExternalPointItemOutputDto: type: object properties: id: type: number description: >- ID del ítem en Tienda de Puntos. Es el identificador que tenés que guardar de tu lado para después pedir la simulación de puntos. example: 87 name: type: string description: Nombre del ítem. example: Café latte points: type: number description: >- Puntos fijos que otorga. Viaja en `null` si el ítem se definió por monto. example: 50 nullable: true amount: type: number description: >- Equivalencia en pesos. Viaja en `null` si el ítem se definió por puntos. example: 3500 nullable: true branchId: type: number description: >- Sucursal a la que está limitado el ítem. Los ítems creados por esta API son globales del comercio y viajan en `null`. example: 1972 nullable: true createdAt: format: date-time type: string description: Fecha de alta. example: '2026-09-21T14:32:11.000Z' updatedAt: format: date-time type: string description: Fecha de la última modificación. example: '2026-09-21T14:32:11.000Z' required: - id - name - points - amount - branchId - createdAt - updatedAt securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key del comercio. Se genera desde el panel de Tienda de Puntos, en Configuración → Integraciones. ````