Retrieve information about a single subscription

GET

/subscriptions/{guid}

const url = 'https://example.com/subscriptions/968cb508-803c-493c-8ff2-9e397dadb83c';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/subscriptions/968cb508-803c-493c-8ff2-9e397dadb83c \
  --header 'Authorization: Bearer <token>'

Retrieve information about a single subscription specified in the path

Authorizations

podcast_auth
read:subscriptions

Parameters

Path Parameters

guid

required

string format: guid

Example

968cb508-803c-493c-8ff2-9e397dadb83c

Responses

200

Successful operation

object

feed_url

required

string format: url

guid

required

string format: guid

is_subscribed

required

boolean

subscription_changed

string format: date-time

new_guid

string format: guid

guid_changed

string format: date-time

deleted

string format: date-time

Example

{
  "feed_url": "https://example.com/feed2",
  "guid": "968cb508-803c-493c-8ff2-9e397dadb83c",
  "is_subscribed": true
}

object

feed_url

required

string format: url

guid

required

string format: guid

is_subscribed

required

boolean

subscription_changed

string format: date-time

new_guid

string format: guid

guid_changed

string format: date-time

deleted

string format: date-time

Example

{
  "feed_url": "https://example.com/feed2",
  "guid": "968cb508-803c-493c-8ff2-9e397dadb83c",
  "is_subscribed": true
}

401

Unauthorized

object

code

required

string

message

required

string

Example

{
  "code": 401,
  "message": "User not authorized"
}

object

code

required

string

message

required

string

Example

{
  "code": 401,
  "message": "User not authorized"
}

404

Not found

object

code

required

string

message

required

string

Example

{
  "code": 404,
  "message": "Resource not found"
}

object

code

required

string

message

required

string

Example

{
  "code": 404,
  "message": "Resource not found"
}

405

Validation exception

object

code

required

string

message

required

string

Example

{
  "code": 405,
  "message": "Input could not be validated"
}

object

code

required

string

message

required

string

Example

{
  "code": 405,
  "message": "Input could not be validated"
}

410

Object deleted

object

code

required

string

message

required

string

Example

{
  "code": 410,
  "message": "Subscription has been deleted"
}

object

code

required

string

message

required

string

Example

{
  "code": 410,
  "message": "Subscription has been deleted"
}