<aside> ⚠️ This API is live and used to import products from e-comm middleware
</aside>
Programa provides a versioned API for integrating with Product data. It is organised around REST and returns JSON-encoded responses.
This documentation describes all of the available API calls and properties of the returned objects. If you have any questions, please reach out to [email protected]
| Number | Description | API Version | Date |
|---|---|---|---|
| 1 | Initial version | 0.1 | 1-Dec-2021 |
| 1.1 | Added the GET Brand API | 0.1 | 7-Feb-2021 |
| 1.2 | Batch Create and Update Product API | 0.1 | 3-Apr-2025 |
Programa uses a token for authentication which is a text string, included in the request header. The authentication bearer token is scoped to your company. If you require a token with a broader scope please contact Programa.
Authorization: Bearer <Your API Key>
This endpoint retrieves the brands a company is configured to sell. Both approved and requested brands are returned by thus endpoint.
GET /api/marketplace/v1/brands
This endpoint allows a product in the marketplace to be created or updated.
A composite key is used to identify a product. The composite key is:
external_product_id (id used to store the product in the seller system)product_sku (the stock keeping unit used by the seller to track the product)