Retrieve a customer subscription How to fetch a specific customer subscription via API
To fetch a single customer subscription, send a GET
request to the /api/customer_subscriptions/:id
endpoint, where id
is the ID of the resource that you want to retrieve.
Request
GET https://yourdomain.commercelayer.io/api/customer_subscriptions/:id
Example
Request Response
The following request fetches the customer subscription identified by the id "xYZkjABcde":
Copy curl -g -X GET \
'https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde' \
-H 'Accept: application/vnd.api+json' \
-H 'Authorization: Bearer your-access-token'
On success, the API responds with a 200 OK
status code, returning a single resource object:
Copy {
"data" : {
"id" : "xYZkjABcde" ,
"type" : "customer_subscriptions" ,
"links" : {
"self" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde"
} ,
"attributes" : {
"created_at" : "2018-01-01T12:00:00.000Z" ,
"customer_email" : "john@example.com" ,
"metadata" : {
"foo" : "bar"
} ,
"reference" : "ANY-EXTERNAL-REFEFERNCE" ,
"reference_origin" : "ANY-EXTERNAL-REFEFERNCE-ORIGIN" ,
"updated_at" : "2018-01-01T12:00:00.000Z"
} ,
"relationships" : {
"customer" : {
"links" : {
"self" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/relationships/customer" ,
"related" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/customer"
}
} ,
"events" : {
"links" : {
"self" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/relationships/events" ,
"related" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/events"
}
} ,
"versions" : {
"links" : {
"self" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/relationships/versions" ,
"related" : "https://yourdomain.commercelayer.io/api/customer_subscriptions/xYZkjABcde/versions"
}
}
} ,
"meta" : {
"mode" : "test"
}
}
}