{ "openapi": "3.1.0", "info": { "title": "Northlight Flowers UCP REST binding", "version": "2026-08-25", "description": "Reference test stores. Nothing here is for sale: test cards only, no goods ship." }, "servers": [ { "url": "https://flowers.ucpsandbox.com/ucp" } ], "paths": { "/checkout-sessions": { "post": { "operationId": "create_checkout", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "201": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } } }, "/checkout-sessions/{id}": { "get": { "operationId": "get_checkout", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } } }, "put": { "operationId": "update_checkout", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } } }, "/checkout-sessions/{id}/complete": { "post": { "operationId": "complete_checkout", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } } }, "/checkout-sessions/{id}/cancel": { "post": { "operationId": "cancel_checkout", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json" } } } } } } }, "/carts": { "post": { "operationId": "create_cart", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "201": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } } }, "/carts/{id}": { "get": { "operationId": "get_cart", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } } }, "put": { "operationId": "update_cart", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } } }, "/carts/{id}/cancel": { "post": { "operationId": "cancel_cart", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json" } } } } } } }, "/catalog/search": { "post": { "operationId": "search_catalog", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_search.json#/$defs/search_response" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_search.json#/$defs/search_request" } } } } } }, "/catalog/lookup": { "post": { "operationId": "lookup_catalog", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json#/$defs/lookup_response" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json#/$defs/lookup_request" } } } } } }, "/catalog/product": { "post": { "operationId": "get_product", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json#/$defs/get_product_response" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json#/$defs/get_product_request" } } } } } }, "/common/locations/search": { "post": { "operationId": "search_locations", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/common/location_search.json#/$defs/search_response" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/common/location_search.json#/$defs/search_request" } } } } } }, "/common/locations/lookup": { "post": { "operationId": "lookup_locations", "parameters": [ { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/common/location_lookup.json#/$defs/lookup_response" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/common/location_lookup.json#/$defs/lookup_request" } } } } } }, "/orders/{id}": { "get": { "operationId": "get_order", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "UCP-Agent", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Request-Id", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "https://ucp.dev/2026-08-25/schemas/shopping/order.json" } } } } } } } } }