GET /products/parents
Requires authentication with server or user access token.
Fetch all products that have children.
See also
Help us improve
Did you spot an error? Or maybe you just have a suggestion for how we can improve? Leave us a comment.
Request
GET /api/2/products/parents
filters | optional
|
|---|
Example request
curl
curl https://login.schibsted.com/api/2/products/parents -G \
-H "Authorization: Bearer [access token]"
Response
This endpoint supports the JSON and JSON-P response formats.
Success: 200 OK
Returns a list of products
Product
productId ✓ | integer (as string)Unique product ID |
|---|---|
parentProductId | integer (as string)ID of the parent product, if any |
clientId ✓ | stringYour client ID |
type ✓ | Product type |
bundle ✓ | Bundle type |
code ✓ | string |
name ✓ | stringProduct display name |
description ✓ | stringA detailed description of the product |
url | URL (string) |
price ✓ | price |
vat ✓ | integer (as string)VAT, fraction × 10000. For instance, 25% would be 2500 |
currency ✓ | stringPrice and VAT currency |
paymentOptions ✓ | Payment optionsAvailable payment options for this product |
quantityLimit | integer (as string)Maximum available sales for this product. |
quantityCount ✓ | integer (as string)Number of sales for this product so far |
saleStart ✓ | datetimeStart of a sale for this product (i.e. reduced price or with additional benefits) |
saleStop ✓ | datetimeEnd of a sale |
availableStart | datetimeWhen this product is available for purchase |
availableStop | datetimeWhen this product is no longer available for purchase |
subscriptionPeriod ✓ | timestamp, in secondsThe subscription period |
subscriptionRenewPrice ✓ | pricePrice of subscription renewal |
subscriptionRenewPeriod ✓ | timestamp, in secondsFor how long a renewal is valid |
subscriptionAutoRenew ✓ | string, "1" (true) or "0" (false)If |
subscriptionAutoRenewLockPeriod ✓ | timestamp, in secondsThe initial period during which auto renew cannot be changed |
subscriptionAutoRenewDisabled ✓ | string, "1" (true) or "0" (false)If |
subscriptionGracePeriod ✓ | integer (as string)The period after a failed renewal charge the subscription will stay active |
subscriptionEmailReceiptLimit ✓ | integer (as string)The maximum number of email receipts |
subscriptionFinalEndDate | datetimeBy this date, the subscription is no longer for sale |
allowMultiSales ✓ | string, "1" (true) or "0" (false)If |
status ✓ | Product status |
changedBy | integer (as string)ID of the user that made the last change |
changed | datetime |
createdBy ✓ | integer (as string)ID of the user that created this product |
created ✓ | datetime |
purchaseUri ✓ | URL (string)A URI where the product may be purchased |
The check mark ✓ indicates that the field always contains a valid non-empty value.
Product status
An enum, with the following possible values:
| Deleted |
|---|---|
| Not available |
| Available, but not visible |
| Available, but not selectable |
| Available |
Payment options
Payment options can be provided as a bit mask.
Bitmask format is the default format. If payment options are not provided, the default value is 2 (bank card with PayEx).
Examples: 2 means credit card, 4 means SMS, while 6 means both credit card and SMS.
An enum, with the following possible values:
| Masterpass |
|---|---|
| Credit card |
| SMS |
| PayEx Invoice |
| Voucher |
| Klarna Invoice |
| Klarna Mobile |
| Wallet |
Bundle type
An enum, with the following possible values:
| Not a bundle |
|---|---|
| Dynamic bundle |
| Onetime bundle |
Failure cases
Some HTTP response codes are used for multiple error situations. There is no consistent way to tell these apart, but the error object will contain a textual explanation of the reason for the error. For explanation on OAuth related failures and errors see OAuth authentication failures.
- 401 Unauthorized You don't have administration rights for this client.
- 401 Unauthorized Your client doesn't have administration rights for this client.
- 403 Forbidden Client is not authorized to access this API endpoint. Contact Schibsted account to request access.
- 403 Forbidden Requesting IP is not whitelisted
- 403 Forbidden Access token rejected
- 404 Not Found Unknown client ID
- 404 Not Found Client ID mismatch. The client making the request is no the owner of this resource, and does not have administrative privileges for it.
- 404 Not Found No parent products found
- 420 Request Ratelimit exceeded
Sample response
JSON
[]
JSON-P
callback([]);
Comments/feedback
Do you have questions, or just want to contribute some newly gained insight? Want to share an example? Please leave a comment. Our team reads and responds to every question. Additionally, your experience can help others using Schibsted account, and it can help us continuously improve our documentation.