Platform Connector API Specification (1.0.0)
Download OpenAPI specification:Download
The Platform Connector API allows Bold to interact with your platform's customers, orders, and products.
This specification file defines the expected server behavior of the Platform Connector Server. Bold applications require the endpoints listed here to be implemented in order to function properly.
Refer to the changelog for the latest updates to this API.
Note: This specification is only for use with a Bold Platform Connector.
Verify Platform Connector Destination
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 200
{ }
Contains information about a customer, including name, contact info, and addresses. Bold calls these endpoints to manage customers on your platform.
Create Customer
Create a customer in your platform.
The request body contains a complete customer entity, you must persistently store on your platform.
A successful response contains the same customer, with its associated platform_id
and timestamps populated. The platform_id
is unique, because Bold applications use it to identify the customer and its fields. The returned platform_id
can be used in requests to other endpoints in this API.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (createCustomerRequestData) | |||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "customer": {
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "addresses": [
- {
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
]
}
}
}
Response samples
- 201
- 500
{- "data": {
- "customer": {
- "addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
], - "platform_created_at": "2021-03-11T17:16:51Z",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "platform_id": "customer-123456",
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555"
}
}
}
List Customers
List customers that have made a purchase from your store. Include the email
parameter to retrieve a certain customer.
Returns a page of customers for your store, with limit
as the maximum number of results and paginated by cursor
. Return customers in ascending order of platform_id
. If the request does not supply a limit (or supplies an invalid one), then use the default limit (250).
Each cursor
points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no cursor
is applied, return the first page of results.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
query Parameters
limit | integer <int32> [ 1 .. 250 ] Default: 250 Example: limit=100 The maximum number of results to return per page. |
cursor | string Example: cursor=dW50ZXN0dW50ZXN0dW50ZXN0 A cursor to obtain the next page of results. Bold takes the value of the cursor directly from the |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 200
- 500
{- "data": {
- "customers": [
- {
- "addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
], - "platform_created_at": "2021-03-11T17:16:51Z",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "platform_id": "customer-123456",
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555"
}
]
}, - "pagination": {
- "next": "dGVzdGluZ3Rlc3Rpbmd0ZXN0aW5n",
- "prev": "dW50ZXN0dW50ZXN0dW50ZXN0"
}
}
Update Customer
Update a customer specified by platform_id
.
Replace all fields of the customer object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: customer-123456 A unique identifier for the customer. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (updateCustomerRequestData) | |||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "customer": {
- "addresses": [
- {
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
], - "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555"
}
}
}
Response samples
- 200
- 404
- 500
{- "data": {
- "customer": {
- "addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
], - "platform_created_at": "2021-03-11T17:16:51Z",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "platform_id": "customer-123456",
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555"
}
}
}
Delete Customer
Delete a customer specified by platform_id
. Mark the customer as deleted within the platform.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: customer-123456 A unique identifier for the customer. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 204
- 404
- 500
{ }
Validate Customer JWT
Validate the JWT to determine if it is a valid token and corresponds to the provided customer. The JWT is used to authorize the frontend code to perform various actions on behalf of the customer. For more information, refer to the Initialize Order endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: customer-123456 A unique identifier for the customer. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (customerValidateRequestData) | |||||||
|
Responses
Request samples
- Payload
{- "data": {
- "token_info": {
- "token": "98qf34jwe0rwfhjqop4wa98af"
}
}
}
Response samples
- 200
- 404
- 500
{- "data": {
- "token_status": {
- "active": true
}
}
}
A child of the Customer resource. Contains information about a billing or shipping address associated with a given customer. Bold calls these endpoints to manage addresses on your platform.
Create Address
Create an address for a customer, specified by platform_customer_id
.
The request body contains a complete address entity, which you must persistently store on the platform. A successful response contains the same address, including its associated platform_id
and platform_customer_id
. These IDs must be unique among addresses, because Bold applications use them to identify the address for the customer. Bold can use the returned platform_id
to make requests to other address endpoints in this API.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_customer_id required | string Example: customer-123456 Unique identifier for the customer. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (createAddressRequestData) | |||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "address": {
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
}
}
Response samples
- 201
- 404
- 500
{- "data": {
- "address": {
- "platform_id": "address-123456",
- "platform_customer_id": "customer-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
}
}
Update Address
Update an address. Bold indicates the address by the platform_id
and the customer by the platform_customer_id
.
Replace all fields of an address object with the values provided in the request body. Ignore and do not change any fields omitted from the request body.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_customer_id required | string Example: customer-123456 Unique identifier for the customer. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (updateAddressRequestData) | |||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "address": {
- "address_type": "commercial",
- "address_use": "billing",
- "company": "Acme Corp.",
- "city": "Winnipeg",
- "country": "Canada",
- "country_code": "CA",
- "is_default": true,
- "first_name": "John",
- "last_name": "Doe",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province": "Manitoba",
- "province_code": "MB",
- "street_1": "123 North Road",
- "street_2": ""
}
}
}
Response samples
- 200
- 404
- 500
{- "data": {
- "address": {
- "platform_id": "address-123456",
- "platform_customer_id": "customer-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
}
}
Delete Address
Delete an address. Bold indicates the address by the platform_id
and the customer by the platform_customer_id
. Mark the address as deleted on the platform.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_customer_id required | string Example: customer-123456 Unique identifier for the customer. Assigned by the platform. |
platform_id required | string Example: address-123456 Unique identifier for the address. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 204
- 404
- 500
{ }
Contains information about an order, including addresses, line items, payments, and additional order details. Bold calls these endpoints to manage orders on your platform.
Create Order
Create an order on the platform.
The request body contains a complete order entity, which you must persistently store on your platform.
A successful response contains the same order, with its associated platform_id
and timestamps populated. The platform_id
is unique, because Bold applications use it to identify the order and its fields. Bold uses the returned platform_id
to make requests to other endpoints in this API.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Idempotency-Key | string Example: qaasc934qfj9aerf Use the HTTP idempotency request header field to carry an idempotency key in order to make non-idempotent HTTP methods, such as POST or PATCH, fault-tolerant. |
Request Body schema: application/jsonrequired
object (createOrderRequestData) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "order": {
- "shipping_addresses": [
- {
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "billing_address": {
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}, - "line_items": [
- {
- "platform_product_id": "product-123456",
- "platform_variant_id": "variant-123456",
- "cart_line_item_platform_id": "cart-line-item-123456",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "title": "Shoes (long-laced classic)",
- "sku": "string",
- "url": "string",
- "image": "string",
- "quantity": 0,
- "grams": 0.1,
- "weight": 0.1,
- "weight_unit": "string",
- "taxable": true,
- "taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "requires_shipping": true,
- "price_per_item": "string",
- "discount_per_item": "string",
- "total": "string",
- "subtotal": "string",
- "total_tax": "0.7",
- "discounted_subtotal": "string"
}
], - "payments": [
- {
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "credit_card",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
], - "order_number": "ORDER_XXYY1122",
- "platform_customer_id": "customer-123456",
- "platform_friendly_id": "PT-0065",
- "shipping_method": "freight",
- "shipping_code": "S001",
- "browser_ip": "127.0.0.1",
- "source": "POS",
- "created_via": "Bold Checkout",
- "locale": "en_US",
- "test": false,
- "notes": "High priority",
- "public_notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_subtotal": "5.00",
- "shipping_tax": "1.00",
- "shipping_taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "discount": "0",
- "discounts": {
- "property1": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}, - "property2": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}
}, - "subtotal": "10.00",
- "subtotal_tax": "0.7",
- "total_tax": "0.7",
- "total": "16.07",
- "refunded_amount": "0",
- "currency": "CAD",
- "order_status": "active",
- "fulfillment_status": "fulfilled",
- "financial_status": "pending"
}
}
}
Response samples
- 201
- 500
{- "data": {
- "order": {
- "platform_id": "order-123456",
- "platform_updated_at": "2019-08-24T14:15:22Z",
- "shipping_addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "billing_address": {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}, - "line_items": [
- {
- "platform_id": "line-item-123456",
- "platform_product_id": "product-123456",
- "platform_variant_id": "variant-123456",
- "cart_line_item_platform_id": "cart-line-item-123456",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "title": "Shoes (long-laced classic)",
- "sku": "string",
- "url": "string",
- "image": "string",
- "quantity": 0,
- "grams": 0.1,
- "weight": 0.1,
- "weight_unit": "string",
- "taxable": true,
- "taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "requires_shipping": true,
- "price_per_item": "string",
- "discount_per_item": "string",
- "total": "string",
- "subtotal": "string",
- "total_tax": "0.7",
- "discounted_subtotal": "string"
}
], - "payments": [
- {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
], - "placed_at": "2019-08-24T14:15:22Z",
- "order_number": "ORDER_XXYY1122",
- "platform_customer_id": "customer-123456",
- "platform_friendly_id": "PT-0065",
- "shipping_method": "freight",
- "shipping_code": "S001",
- "browser_ip": "127.0.0.1",
- "source": "POS",
- "created_via": "Bold Checkout",
- "locale": "en_US",
- "test": false,
- "notes": "High priority",
- "public_notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_subtotal": "5.00",
- "shipping_tax": "1.00",
- "shipping_taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "discount": "0",
- "discounts": {
- "property1": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}, - "property2": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}
}, - "subtotal": "10.00",
- "subtotal_tax": "0.7",
- "total_tax": "0.7",
- "total": "16.07",
- "refunded_amount": "0",
- "currency": "CAD",
- "order_status": "active",
- "fulfillment_status": "fulfilled",
- "financial_status": "pending"
}
}
}
List Orders
List all orders made on a store.
Return a page of orders from your store, with limit
as the maximum number of results and paginated by cursor
. Return orders in ascending order of platform_id
. If the request does not supply a limit (or supplies an invalid one), then use the default limit (250).
Each cursor
points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no cursor
is supplied, return the first page of results.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
query Parameters
limit | integer <int32> [ 1 .. 250 ] Default: 250 Example: limit=100 The maximum number of results to return per page. |
cursor | string Example: cursor=dW50ZXN0dW50ZXN0dW50ZXN0 A cursor to obtain the next page of results. Bold takes the value of the cursor directly from the |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 200
- 500
{- "data": {
- "orders": [
- {
- "platform_id": "order-123456",
- "platform_updated_at": "2019-08-24T14:15:22Z",
- "shipping_addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "billing_address": {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}, - "line_items": [
- {
- "platform_id": "line-item-123456",
- "platform_product_id": "product-123456",
- "platform_variant_id": "variant-123456",
- "cart_line_item_platform_id": "cart-line-item-123456",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "title": "Shoes (long-laced classic)",
- "sku": "string",
- "url": "string",
- "image": "string",
- "quantity": 0,
- "grams": 0.1,
- "weight": 0.1,
- "weight_unit": "string",
- "taxable": true,
- "taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "requires_shipping": true,
- "price_per_item": "string",
- "discount_per_item": "string",
- "total": "string",
- "subtotal": "string",
- "total_tax": "0.7",
- "discounted_subtotal": "string"
}
], - "payments": [
- {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
], - "placed_at": "2019-08-24T14:15:22Z",
- "order_number": "ORDER_XXYY1122",
- "platform_customer_id": "customer-123456",
- "platform_friendly_id": "PT-0065",
- "shipping_method": "freight",
- "shipping_code": "S001",
- "browser_ip": "127.0.0.1",
- "source": "POS",
- "created_via": "Bold Checkout",
- "locale": "en_US",
- "test": false,
- "notes": "High priority",
- "public_notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_subtotal": "5.00",
- "shipping_tax": "1.00",
- "shipping_taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "discount": "0",
- "discounts": {
- "property1": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}, - "property2": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}
}, - "subtotal": "10.00",
- "subtotal_tax": "0.7",
- "total_tax": "0.7",
- "total": "16.07",
- "refunded_amount": "0",
- "currency": "CAD",
- "order_status": "active",
- "fulfillment_status": "fulfilled",
- "financial_status": "pending"
}
]
}, - "pagination": {
- "next": "dGVzdGluZ3Rlc3Rpbmd0ZXN0aW5n",
- "prev": "dW50ZXN0dW50ZXN0dW50ZXN0"
}
}
Get Order
Retrieve an order placed on your store by the specified platform_id
.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: order-123456 Unique identifier for the order. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Responses
Response samples
- 200
- 404
- 500
{- "data": {
- "order": {
- "platform_id": "order-123456",
- "platform_updated_at": "2019-08-24T14:15:22Z",
- "shipping_addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "billing_address": {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}, - "line_items": [
- {
- "platform_id": "line-item-123456",
- "platform_product_id": "product-123456",
- "platform_variant_id": "variant-123456",
- "cart_line_item_platform_id": "cart-line-item-123456",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "title": "Shoes (long-laced classic)",
- "sku": "string",
- "url": "string",
- "image": "string",
- "quantity": 0,
- "grams": 0.1,
- "weight": 0.1,
- "weight_unit": "string",
- "taxable": true,
- "taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "requires_shipping": true,
- "price_per_item": "string",
- "discount_per_item": "string",
- "total": "string",
- "subtotal": "string",
- "total_tax": "0.7",
- "discounted_subtotal": "string"
}
], - "payments": [
- {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
], - "placed_at": "2019-08-24T14:15:22Z",
- "order_number": "ORDER_XXYY1122",
- "platform_customer_id": "customer-123456",
- "platform_friendly_id": "PT-0065",
- "shipping_method": "freight",
- "shipping_code": "S001",
- "browser_ip": "127.0.0.1",
- "source": "POS",
- "created_via": "Bold Checkout",
- "locale": "en_US",
- "test": false,
- "notes": "High priority",
- "public_notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_subtotal": "5.00",
- "shipping_tax": "1.00",
- "shipping_taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "discount": "0",
- "discounts": {
- "property1": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}, - "property2": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}
}, - "subtotal": "10.00",
- "subtotal_tax": "0.7",
- "total_tax": "0.7",
- "total": "16.07",
- "refunded_amount": "0",
- "currency": "CAD",
- "order_status": "active",
- "fulfillment_status": "fulfilled",
- "financial_status": "pending"
}
}
}
Update Order
Update an order specified by platform_id
.
Replace all fields of the order object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: order-123456 Unique identifier for the order. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (updateOrderRequestData) | |||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "order": {
- "fulfillment_status": "partial",
- "financial_status": "pending",
- "refunded_amount": "0",
- "notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_addresses": [
- {
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "subtotal": "string",
- "subtotal_tax": "0.7"
}
}
}
Response samples
- 200
- 404
- 500
{- "data": {
- "order": {
- "platform_id": "order-123456",
- "platform_updated_at": "2019-08-24T14:15:22Z",
- "shipping_addresses": [
- {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}
], - "billing_address": {
- "platform_id": "address-123456",
- "address_type": "billing",
- "first_name": "John",
- "last_name": "Doe",
- "street_1": "123 North Road",
- "street_2": "Suite 200",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country": "Canada",
- "country_code": "CA",
- "phone": "555-555-5555",
- "postal_code": "H0H 0H0",
- "province_code": "MB",
- "company": "Acme Corp."
}, - "line_items": [
- {
- "platform_id": "line-item-123456",
- "platform_product_id": "product-123456",
- "platform_variant_id": "variant-123456",
- "cart_line_item_platform_id": "cart-line-item-123456",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "title": "Shoes (long-laced classic)",
- "sku": "string",
- "url": "string",
- "image": "string",
- "quantity": 0,
- "grams": 0.1,
- "weight": 0.1,
- "weight_unit": "string",
- "taxable": true,
- "taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "requires_shipping": true,
- "price_per_item": "string",
- "discount_per_item": "string",
- "total": "string",
- "subtotal": "string",
- "total_tax": "0.7",
- "discounted_subtotal": "string"
}
], - "payments": [
- {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
], - "placed_at": "2019-08-24T14:15:22Z",
- "order_number": "ORDER_XXYY1122",
- "platform_customer_id": "customer-123456",
- "platform_friendly_id": "PT-0065",
- "shipping_method": "freight",
- "shipping_code": "S001",
- "browser_ip": "127.0.0.1",
- "source": "POS",
- "created_via": "Bold Checkout",
- "locale": "en_US",
- "test": false,
- "notes": "High priority",
- "public_notes": "Handle with care.",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "shipping_subtotal": "5.00",
- "shipping_tax": "1.00",
- "shipping_taxes": [
- {
- "amount": "0.7",
- "name": "Provincial Sales Tax",
- "rate": "0.07",
- "tag": "PST"
}
], - "discount": "0",
- "discounts": {
- "property1": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}, - "property2": {
- "platform_id": "discount-123456",
- "amount": "5.00",
- "discount_code": "20OFF"
}
}, - "subtotal": "10.00",
- "subtotal_tax": "0.7",
- "total_tax": "0.7",
- "total": "16.07",
- "refunded_amount": "0",
- "currency": "CAD",
- "order_status": "active",
- "fulfillment_status": "fulfilled",
- "financial_status": "pending"
}
}
}
Create Payment
Create a payment associated with a given order.
The request body contains a complete order entity, which you must persistently store on your platform.
A successful response contains the same payment, with its associated platform_id
and timestamps populated. The platform_id
must be unique, because Bold applications use it to identify the payment and its fields. The returned platform_id
can be used in requests to other endpoints in this API.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
platform_id required | string Example: order-123456 Unique identifier for the order. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (createPaymentRequestData) | |||||||||||||||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "payment": {
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "credit_card",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
}
}
Response samples
- 201
- 404
- 500
{- "data": {
- "payment": {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
}
}
Update Payment
Update a payment associated with a specific order. Specify the payment by platform_id
and the order by order_platform_id
.
Replace all fields of the payment object with the values provided in the request body. Ignore and do not update any fields omitted from the request body.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
order_platform_id required | string Example: order-123456 Unique identifier for the order. Assigned by the platform. |
platform_id required | string Example: payment-123456 Unique identifier for the payment. Assigned by the platform. |
header Parameters
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
Request Body schema: application/jsonrequired
object (updatePaymentRequestData) | |||||||||
|
Responses
Request samples
- Payload
{- "data": {
- "payment": {
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "status": "paid"
}
}
}
Response samples
- 200
- 404
- 500
{- "data": {
- "payment": {
- "platform_id": "payment-123456",
- "transactions": [
- {
- "platform_id": "transaction-123456",
- "provider_transaction_id": "provider-transaction-123456",
- "amount": "string",
- "currency": "CAD",
- "status": "pending",
- "type": "charge"
}
], - "description": "Credit card payment",
- "provider": "stripe",
- "payment_method": "credit card",
- "currency": "CAD",
- "amount_planned": "16.07",
- "custom_attributes": {
- "property1": {
- "description": "key-1",
- "value": "value-1"
}, - "property2": {
- "description": "key-1",
- "value": "value-1"
}
}, - "status": "paid"
}
}
}
Contains information about a product, including names, descriptions, applicable options and variants, and other details. Bold calls these endpoints to retrieve information about the products on your platform.
List Products
List all products that exist in your store.
Return a page of products for your store, with limit
as the maximum number of results and paginated by cursor
. Return products in ascending order of platform_id
. If the request does not supply a limit (or supplies an invalid one), use the default limit (250).
Each cursor
points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no cursor
is supplied, return the first page of results.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
query Parameters
limit | integer <int32> [ 1 .. 250 ] Default: 250 Example: limit=100 The maximum number of results to return per page. |
cursor | string Example: cursor=dW50ZXN0dW50ZXN0dW50ZXN0 A cursor to obtain the next page of results. Bold takes the value of the cursor directly from the |
header Parameters
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
Responses
Response samples
- 200
- 500
{- "data": {
- "products": [
- {
- "platform_id": "product-123456",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "categories": [
- {
- "platform_id": "category-123456",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "image_url": "your_platform_connector.com/files/categories/hats.jpg",
- "name": "Hats"
}
], - "variants": [
- {
- "platform_id": "variant-123456",
- "option_values": [
- {
- "platform_id": "variant-option-value-123456",
- "platform_product_option_id": "product-option-123456",
- "label": "small",
- "name": "Small"
}
], - "allow_backorder": true,
- "compare_at_price": "30.00",
- "cost": "30.00",
- "grams": 0,
- "image_url": "your_platform_connector.com/files/products/hats/purple-beach-hat.jpg",
- "inventory_quantity": 0,
- "inventory_tracking_entity": "variant",
- "inventory_tracking_service": "platform",
- "localized_names": {
- "en": "Purple",
- "fr": "Violette"
}, - "name": "Default Title",
- "price": "30.00",
- "require_shipping": true,
- "sku": "BEACH-HAT-PURPLE",
- "tax_code": "non-taxable",
- "tax_exempt": true,
- "weight": "1.0",
- "weight_unit": "kg"
}
], - "options": [
- {
- "platform_id": "product-option-123456",
- "option_values": [
- {
- "platform_id": "option-value-123456",
- "is_default": true,
- "label": "Small",
- "position": 1
}
], - "name": "Small",
- "position": 2
}
], - "images": [
- {
- "platform_id": "image-123456",
- "name": "Beach hat",
- "src": "your_platform_connector.com/files/images/beach-hat.jpg",
- "position": 2
}
], - "description": "A hat for the beach",
- "handle": "beach-hat",
- "inventory_quantity": 4,
- "inventory_tracking_entity": "product",
- "inventory_tracking_service": "platform",
- "localized_descriptions": {
- "en": "A hat for the beach",
- "fr": "Un chapeau pour la plage"
}, - "localized_names": {
- "en": "Beach Hat",
- "fr": "Chapeau de Plage"
}, - "name": "Beach hat",
- "published": true,
- "tags": "clothing, unisex, pants",
- "tax_code": "non-taxable",
- "type": "physical",
- "url": "/hats/beach-hat",
- "vendor": "OFS"
}
]
}, - "pagination": {
- "next": "dGVzdGluZ3Rlc3Rpbmd0ZXN0aW5n",
- "prev": "dW50ZXN0dW50ZXN0dW50ZXN0"
}
}
Contains information about product categories, including names, image, and platform information. Bold calls these endpoints to retrieve information about the categories on your platform.
List Categories
Lists all product categories in a given store.
Return a page of product categories for your store, with limit
as the maximum number of results and paginated by cursor
. Return categories in ascending order of platform_id
. If the request does not supply a limit (or supplies an invalid one), use the default limit (250).
Each cursor points to a location in the dataset. Cursors can be supplied to subsequent calls for additional data in the dataset. If no cursor
is supplied, return the first page of results.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 A unique identifier of the store. This can be retrieved by calling the Get Shop Info endpoint. |
query Parameters
limit | integer <int32> [ 1 .. 250 ] Default: 250 Example: limit=100 The maximum number of results to return per page. |
cursor | string Example: cursor=dW50ZXN0dW50ZXN0dW50ZXN0 A cursor to obtain the next page of results. Bold takes the value of the cursor directly from the |
header Parameters
User-Agent required | string Example: Bold-API A value to help filter traffic from Bold through any firewall system. Bold sends requests to your Platform Connector with the value |
X-HMAC-Timestamp required | string <date-time> Example: 2021-03-11T17:16:51Z The UTC server time (in RFC 3339 format) at the moment the request was sent, signed as a part of calculating X-HMAC and X-Compatible-HMAC values. |
Responses
Response samples
- 200
- 500
{- "data": {
- "categories": [
- {
- "platform_id": "category-123456",
- "platform_updated_at": "2021-03-11T17:16:51Z",
- "image_url": "your_platform_connector.com/files/categories/hats.jpg",
- "name": "Hats"
}
]
}, - "pagination": {
- "next": "dGVzdGluZ3Rlc3Rpbmd0ZXN0aW5n",
- "prev": "dW50ZXN0dW50ZXN0dW50ZXN0"
}
}