Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Canal refunds API

The refunds API from Canal — 2 operation(s) for refunds.

Canal refunds API is one of 17 APIs that Canal publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include refunds. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 3 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.0.3, at version 1.0.1.

Requests are made against a single base URL, https://api.shopcanal.com/platform.

3 operations 2 paths 7 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.1
Base URL
https://api.shopcanal.com/platform
Authentication
HTTP Basic, API Key, API Key
Resource Areas
1

Authentication & Security 3

Canal refunds API declares 3 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). An API key is passed in the header as X-CANAL-APP-ID (platformAppId). An API key is passed in the header as X-CANAL-APP-TOKEN (platformAppToken).

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

refunds 3
GET
/refunds/
Retrieve a paginated list of refund records associated with the authenticated store, reflecting its role in the order process. - If called by a Storefront: Returns refund records linked to orders ori…
refunds_list 2 params → 200400401404
POST
/refunds/
Initiate a refund for specific quantities of line items within a Rokt Catalog order. This endpoint handles refund requests originating from both Storefronts and Suppliers. Request Body (RefundCreateS…
refunds_create body → 201400401403404
GET
/refunds/{id}/
Retrieve the full details for a specific refund record, identified by its Rokt Catalog ID (UUID) in the URL path. Access is restricted to refunds associated with orders linked to the authenticated st…
refunds_retrieve 1 param → 200400401404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Refund (10 properties), LineItemRead (8 properties), RefundLineItem (4 properties), RefundCreate (4 properties). Each schema is shown below with its type and property counts.

RefundCreate
object
4 properties 2 required
Refund
object
10 properties 6 required
PaginatedRefundList
object
3 properties 1 required
RefundLineItem
object
4 properties 3 required
LineItemRead
object
8 properties 5 required
Error
object
2 properties
LineItem
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

canal-refunds-api-openapi.yml Raw ↑

Other APIs Canal publishes across the network.

Canal csv API
Canal fulfillments API
Canal markets API
Canal max-shipping-rates API
Canal orders API
Canal product_sets API
Canal products API
Canal returns API
Canal selection API
Canal shipping API
Canal shipping-rates API
Canal shops API