> ## Documentation Index > Fetch the complete documentation index at: https://docs.bevits.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar compras > Lista compras con filtros por cliente, estado, plataforma, período y valor. ## OpenAPI ````yaml /openapi.es.json get /v1/purchases openapi: 3.1.0 info: title: API de Bevits version: 1.0.0 description: >- API pública de solo lectura para consultar datos de CRM, compras y automatización de una organización de Bevits. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.bevits.com description: Producción security: - bearerAuth: [] tags: - name: Sistema description: Disponibilidad de la API. - name: Identidad description: Identidad de la organización y de la clave API. - name: Clientes description: Clientes y sus relaciones. - name: Segmentos description: Segmentos de clientes. - name: Compras description: Compras importadas desde las integraciones. - name: Datos del CRM description: Etiquetas y definiciones de atributos. - name: Automatizaciones description: Flows de automatización. - name: Campañas description: Campañas de email. paths: /v1/purchases: get: tags: - Compras summary: Listar compras description: >- Lista compras con filtros por cliente, estado, plataforma, período y valor. operationId: listPurchases parameters: - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/PurchaseCursor' - $ref: '#/components/parameters/CustomerFilter' - $ref: '#/components/parameters/PurchaseStatus' - $ref: '#/components/parameters/Platform' - $ref: '#/components/parameters/CreatedSince' - $ref: '#/components/parameters/CreatedUntil' - $ref: '#/components/parameters/MinValue' - $ref: '#/components/parameters/MaxValue' responses: '200': $ref: '#/components/responses/PurchasePage' '401': $ref: '#/components/responses/Unauthorized' '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: Limit: name: limit in: query description: Cantidad máxima de elementos por página. schema: type: integer minimum: 1 maximum: 100 default: 25 PurchaseCursor: name: starting_after in: query description: ID de la última compra de la página anterior. schema: type: string pattern: ^pur_[A-Za-z0-9_-]+$ CustomerFilter: name: customer_id in: query description: Filtra compras por cliente. schema: type: string pattern: ^cus_[A-Za-z0-9_-]+$ PurchaseStatus: name: status in: query description: Filtra por el estado financiero de la compra. schema: type: string enum: - any - pending - authorized - paid - abandoned - refunded - voided Platform: name: platform in: query description: Filtra por la plataforma de origen. schema: type: string enum: - nuvemshop - shopify - woocommerce - bling - instagram - popup CreatedSince: name: created_since in: query description: Incluye elementos creados desde este instante, inclusive. schema: type: string format: date-time CreatedUntil: name: created_until in: query description: Incluye elementos creados hasta este instante, inclusive. schema: type: string format: date-time MinValue: name: min_value_in_cents in: query description: Valor mínimo de la compra en centavos. schema: type: integer minimum: 0 MaxValue: name: max_value_in_cents in: query description: Valor máximo de la compra en centavos. schema: type: integer minimum: 0 responses: PurchasePage: description: Página de compras. headers: ETag: $ref: '#/components/headers/ETag' X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/PurchasePage' Unauthorized: description: Clave API ausente, inválida, expirada o revocada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error message: Invalid API key. request_id: req_07f6cdc3c20249d6afcd90b4 ValidationError: description: Un parámetro no superó la validación. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: validation_error message: Invalid query parameters. param: limit request_id: req_07f6cdc3c20249d6afcd90b4 RateLimited: description: Límite de solicitudes superado. headers: Retry-After: $ref: '#/components/headers/RetryAfter' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' InternalError: description: Error inesperado en el servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: ETag: description: Identificador de la versión del contenido para caché condicional. schema: type: string example: '"v1-4ad31f5efb6b8f35"' RequestId: description: Identificador de la solicitud para soporte y rastreo. schema: type: string pattern: ^req_[a-f0-9]{24}$ RetryAfter: description: Segundos antes de volver a intentarlo. schema: type: integer minimum: 1 RateLimitLimit: description: Límite total de la ventana actual. schema: type: integer example: 600 RateLimitRemaining: description: Solicitudes restantes en la ventana actual. schema: type: integer example: 599 RateLimitReset: description: Instante UTC en que termina la ventana actual. schema: type: string format: date-time schemas: PurchasePage: allOf: - $ref: '#/components/schemas/Page' - type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/Purchase' ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' RateLimitErrorResponse: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object required: - retry_after properties: retry_after: type: integer minimum: 1 description: Segundos antes de volver a intentarlo. Page: type: object required: - data - has_more properties: has_more: type: boolean description: Indica si existe una página siguiente. Purchase: type: object required: - object - id - customer_id - purchase_value_in_cents - created_at - updated_at properties: object: type: string const: purchase id: type: string pattern: ^pur_[A-Za-z0-9_-]+$ customer_id: type: string pattern: ^cus_[A-Za-z0-9_-]+$ order_id_on_integration_platform: type: string order_number: type: string platform: type: string status: type: string payment_status: type: string shipping_status: type: string currency: type: string example: BRL purchase_value_in_cents: type: integer subtotal_amount_in_cents: type: integer total_amount_in_cents: type: integer discount_in_cents: type: integer shipping_cost_customer_in_cents: type: integer coupons: type: array items: $ref: '#/components/schemas/Coupon' attributed_flow_ids: type: array items: type: string pattern: ^flw_[A-Za-z0-9_-]+$ created_at: type: string format: date-time updated_at: type: string format: date-time Error: type: object required: - type - message - request_id properties: type: type: string enum: - authentication_error - conflict - internal_error - invalid_request - not_found - permission_denied - rate_limited - validation_error message: type: string param: type: string request_id: type: string pattern: ^req_[a-f0-9]{24}$ Coupon: type: object required: - id - code - value - type properties: id: type: string code: type: string value: type: number type: type: string securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: bvt_live_... description: Clave API creada en la configuración de la organización. ````