Base URL: https://yoursite.com/wp-json/utb/v1
All endpoints require authentication .
List orders GET /wp-json/utb/v1/orders
Returns a paginated list of WooCommerce orders. Each order is built by OrderDataBuilder and includes customer data, line items, form submissions, and uploaded files.
Query parameters Number of results per page. Minimum: 1, maximum: 100.
Filter by WooCommerce order status. Accepted values: pending, processing, on-hold, completed, cancelled, refunded, failed.
Filter by a specific order ID.
Filter by UTB flow ID (e.g. utb_cep_programs, certificados_academicos).
Return orders created on or after this date. Format: YYYY-MM-DD.
Return orders created on or before this date. Format: YYYY-MM-DD.
Response Total number of orders matching the query.
Number of results per page for this response.
curl "https://yoursite.com/wp-json/utb/v1/orders?status=completed&per_page=10" \ -H "X-UTB-API-Key: your-api-key-here"
Get a single order GET /wp-json/utb/v1/orders/{id}
Returns the full data payload for a single order.
Path parameters The WooCommerce order ID.
curl "https://yoursite.com/wp-json/utb/v1/orders/1042" \ -H "X-UTB-API-Key: your-api-key-here"
Order object Core WooCommerce order fields. Human-readable order number.
Order status (e.g. completed).
Order subtotal before discounts.
ISO 8601 creation timestamp.
ISO 8601 payment timestamp, or null.
Payment method display name.
Note left by the customer at checkout.
Billing and shipping information for the order’s customer. WordPress user ID (0 for guests).
Standard billing address fields plus any custom fields from WooCommerce Checkout Manager plugins (auto-discovered from order meta). ISO 3166-1 alpha-2 country code.
Shipping address fields (same structure as billing).
One object per WooCommerce line item. WooCommerce order item ID.
Item subtotal before discounts.
Item total after discounts.
Per-product webhook and integration settings stored in _utb_order_metadata post meta.
UTB flow ID, if the product has one assigned (e.g. utb_cep_programs).
Human-readable flow name.
Key/value pairs from the UTB form captured at checkout (stored in _utb_form_data item meta).
Files uploaded through the flow form. Each key is a field name; each value contains file metadata plus a download_url.
Present for utb_cep_programs flow. Enriched data from the CEPProgramsRepository including pricing and discount information.
Present for certificados_academicos flow. Enriched certificate data from CertificatesRepository.
Present for certificados_academicos flow. Academic program data from ProgramsRepository.
Present for certificados_academicos flow. Contains tipo_solicitante, formato_entrega, and cantidad.
Order-level metadata. ISO 8601 creation timestamp.
ISO 8601 last-modified timestamp.
Row ID in wp_utb_product_submissions, if present.
Payment status from the submissions table.
Example response { "order" : { "id" : 1042 , "number" : "1042" , "status" : "completed" , "currency" : "COP" , "total" : "150000.00" , "subtotal" : "150000.00" , "discount_total" : "0.00" , "date_created" : "2026-03-18T14:00:00+00:00" , "date_paid" : "2026-03-18T14:01:22+00:00" , "payment_method" : "wompi" , "payment_method_title" : "Wompi" , "transaction_id" : "txn_abc123" , "customer_note" : "" }, "customer" : { "id" : 7 , "email" : "[email protected] " , "first_name" : "Maria" , "last_name" : "Garcia" , "phone" : "3001234567" , "billing" : { "address_1" : "Cra 7 # 45-10" , "city" : "Bogotá" , "country" : "CO" }, "shipping" : {} }, "items" : [ { "item_id" : 88 , "product_id" : 210 , "product_name" : "Inscripción Diplomado Gestión" , "sku" : "DIP-GEST-001" , "quantity" : 1 , "subtotal" : "150000.00" , "total" : "150000.00" , "flow_id" : "utb_cep_programs" , "flow_name" : "Programas CEP" , "form_submission" : { "cep_programa" : "DIP-GEST" }, "program_details" : { "id" : 12 , "codigo" : "DIP-GEST" , "nombre" : "Diplomado en Gestión" , "sku" : "DIP-GEST-001" , "precio_base" : "150000.00" , "activo" : true , "precio_final" : "150000.00" , "aplica_descuento_utb" : false }, "uploaded_files" : {}, "product_metadata" : { "webhook_url" : "https://erp.ejemplo.co/webhooks/inscripciones" , "enviar_automatico" : true } } ], "metadata" : { "created_at" : "2026-03-18T14:00:00+00:00" , "updated_at" : "2026-03-18T14:01:22+00:00" , "submission_id" : 53 , "payment_status" : "completed" } }