Retrieve information about a single subscription

GET

/v1/subscriptions/{guid}

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

{
  "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

{
  "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"
}